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/zulip-fedi-auth -s /bin/bash zulip-fedi-auth`
2. clone this repo into a subdirectory in zulip-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/