Get Started in 5 Minutes

Run 24 microservices, add auth to your app, or deploy to production. All open source under AGPL.

Run the Platform

git clone https://github.com/autional/authms
cd authms
docker compose -f docker-compose.infra.yml -f docker-compose.monolith.yml up -d

# Wait 2-3 minutes for all 24 services to start

Visit the full documentation portal →

Install the SDK

npm install @autional/react @autional/core

Visit the full documentation portal →

Add Auth to Your App

import { AuthProvider } from '@autional/react';

function App() {
  return (
    
      
    
  );
}

Visit the full documentation portal →

Or Self-Host with Docker

# Quick start with Docker
curl -sL https://docs.autional.com/quickstart/docker-compose.yml > docker-compose.yml
docker compose up -d

# Visit http://localhost:11001 for the admin console
# Default: admin@admin.com / admin123

Visit the full documentation portal →

API Reference

All 24 microservices have interactive Swagger/OpenAPI documentation. Key services and their base paths:

Identity:11001

Auth, registration, password management, SSO, RBAC

/api/v1/auth/login

MFA:11005

TOTP, WebAuthn/FIDO2, SMS, email OTP, adaptive MFA

/api/v1/mfa/totp/setup

OAuth:11006

OAuth 2.1, OIDC, DPoP, token exchange, device code

/oauth/token

Tenant:11003

Multi-tenant CRUD, departments, branding, invitations

/api/v1/tenants

RBAC:11025

Roles, permissions, SoD, approval workflow

/api/v1/admin/roles

Audit:11013

Merklke hash chain audit, anomaly detection, SIEM

/api/v1/internal/audit-logs

Session:11004

Session CRUD, token blacklist, device trust, analytics

/api/v1/sessions

Profile:11002

User profiles, privacy, tags, consent, data export

/api/v1/profiles

Full OpenAPI spec: github.com/autional/authms → docker/specs/

Common Questions

What ports are used?+

Services run on ports 11001–11025 (HTTP) and 12001–12025 (gRPC). The gateway is on port 11080, PostgreSQL on 15432, Redis on 16379. See docs for full port map.

What are the default credentials?+

Default admin: admin@admin.com / admin123. For production, change passwords and configure JWT_SECRET, PASSWORD_PEPPER, and other secrets.

How do I enable HTTPS?+

See docker/nginx/certs/ for 100-year self-signed certificates. For production, use Let's Encrypt or your CA. SSL termination is handled by the nginx gateway.