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.
Type the addresses you plan to use. Everything below updates automatically.
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.
Open your AuthForge login page in a browser and create a test account. If you are technical, you can also run these checks:
Add a sign-in link or paste the SDK snippet on your website. Switch to the Link-only tab for copy-paste HTML.
The simplest integration — send users to AuthForge to sign in. No JavaScript required on your site.
For a seamless experience, add the SDK to your site header or login page:
Full SDK reference: Documentation → SDK
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.
AuthForge
internal_port = 8080persistent = true (keeps signing keys across redeploys)In Ratel app settings, add a managed Postgres database, then paste (generate the pepper once — never rotate it):
Paste this on any page where you want sign-in, or use the SDK snippet in the Link-only tab:
Work through these in order. Each step links to the exact page you need.
Copy this summary and send it to whoever deploys your server. It includes your domains and the pages they need.
You can skip deployment entirely and use the hosted workspace at auth.authforge.dev. Sign up, open your dashboard, and upgrade from there — same features, no server to manage.