AuthForge
Configure AuthForge for your website
You do not need to be a developer, and you do not need Ratel. Run AuthForge on any VPS, Docker host, or cloud — we generate the exact settings to copy into your server. Then add one link or one script to your site.
Your domains
Type the addresses you plan to use. Everything below updates automatically.
1 Run locally or on your VPS
Clone the repo, set a pepper, and start the stack on any server you control:
docker compose up --build
Open http://localhost:8080/login.html to test. For production, paste the environment variables below and point your reverse proxy (Caddy, nginx, etc.) at port 8080.
2 Production environment
3 Verify login works
1 Already deployed? Add a sign-in link
The simplest integration — send users to AuthForge to sign in. No JavaScript required on your site.
2 Or embed login with one script
For a seamless experience, add the SDK to your site header or login page:
Full SDK reference: Documentation → SDK
1 Create a Ratel project (optional)
Prefer a managed platform? Sign in at getratel.com, connect the AuthForge GitHub repo, and create a backend app. You can also self-host on any VPS using the Docker tab — Ratel is not required.
internal_port = 8080persistent = true(keeps signing keys across redeploys)- Attach your AuthForge domain from the planner above
2 Paste these environment variables
In Ratel app settings, add a managed Postgres database, then paste (generate the pepper once — never rotate it):
3 Verify login works
4 Connect your website
Paste this on any page where you want sign-in, or use the SDK snippet in the Link-only tab: