zulip-fediverse-auth/README.md

zulip-fediverse-auth

Authenticate to Zulip using Pleroma or Mastodon.

You will need to have a user on the zulip system that has permission to create new users and have an api key for it. Instructions will be added to this document at a later point.

1. useradd -r -m -d /var/lib/fedi-auth -s /bin/bash fedi-auth
2. clone this repo into a subdirectory in fedi-auth user's home directory
3. create a venv, start it and run pip install -r requirements.txt
4. copy the systemd unit file into /etc/systemd/system and tailor it to your environment, and enable and start it
5. using nginx and letsencrypt or your other preference, to reverse-proxy the command under TLS at /fedi-auth/