Quickstart

Deploy Passport Auth in minutes.

Use Docker Compose locally or point Coolify at the repository. The web container exposes the app; Postgres, Redis, and ClickHouse stay internal.

1

Clone and configure

git clone https://github.com/aeon-pro/passport-auth.git
cd passport-auth
cp .env.example .env
2

Boot the stack

docker compose up -d
3

Create the owner

Open your auth domain and finish onboarding. Create the owner account first; configure domains, Resend, Google OAuth, branding, and templates after.

4

Connect your app

Add your application domain, allowed origins, and redirect URLs. Use hosted pages with PKCE or call the public auth API from your own frontend.

Coolify

Use the Docker Compose deployment mode.

Keep the generated volumes stable so Postgres, Redis, ClickHouse, and uploaded dashboard assets persist between redeploys.

Read deployment notes