sooauthHome

Self-host (optional)

Most users run on our hosted auth.sooauth.com. Self-hosting is for teams that want their own domain and data residency.

Step 1

Requirements

  • · Docker + Docker Compose
  • · VPS with ~1 GB RAM free
  • · SMTP for production email
  • · A domain (e.g. auth.yourcompany.com)

Step 2

Deploy stack

Use the monorepo compose file:

git clone https://github.com/<org>/sooauth
cp .env.coolify.example .env
# set POSTGRES_PASSWORD, SMTP_URL, APP_URL, ADMIN_EMAILS
docker compose -f docker-compose.coolify.yml up -d

Step 3

Domain & TLS

Point your auth subdomain to the server. Coolify/Traefik or Caddy terminates TLS. Set APP_URL to your public HTTPS origin.

Step 4

Verify

curl https://auth.yourcompany.com/healthz
curl https://auth.yourcompany.com/.well-known/openid-configuration