auth-engine

Production-ready backend API for AuthEngine — multi-tenant IAM, RBAC, OIDC provider, social login, MFA, passkeys, and token introspection.

Built with FastAPI and PostgreSQL. Migrations via Alembic; seeding is handled separately by auth-engine-data.

Development

Requires Python 3.12+, uv, and running Postgres, MongoDB, and Redis.

cd auth-engine
uv sync
cp .env.example .env.local
auth-engine migrate
auth-engine run              # add --reload for hot reload

Seed once (after migrate):

cd ../auth-engine-data
uv sync && cp .env.example .env.local
uv run auth-engine-data all

Full stack (API + dashboard + databases) from auth-engine-infra/compose:

cd auth-engine-infra/compose
cp env.local.example .env
docker compose up -d
docker exec authengine-api auth-engine migrate

Then seed from auth-engine-data (see auth-engine-data README).

Path	Guide
Local VM + Cloudflare Tunnel	deploy-local-vm.sh
AWS EC2 or any cloud VM	deploy-aws.sh

Docker image: qniranjan01/authengine:latest

Guide	Link
Quick Start	docs.authengine.org/quick-start
Deployment	docs.authengine.org/deployment
API Reference	docs.authengine.org/api-reference
OAuth2 / OIDC	docs.authengine.org/oauth2-oidc-guides
Architecture	docs.authengine.org/architecture
Security	docs.authengine.org/security-overview