Stack Auth

Development1024MB+ RAM

Open-source, self-hosted alternative to Auth0/Clerk — full user management, OAuth, magic links, and team/permission management with a React SDK

Download Server Compass Install Stack Auth to server

developmentiamstackauthopen-sourceself-hosteddocker

Deploy Stack Auth in 3 Steps

Connect Your VPS

Add your server credentials to Server Compass

Select Stack Auth

Choose from our template library

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required

Step-by-step deployment guide

Deploy Stack Auth on a VPS with Server Compass

Use the Stack Auth template in Server Compass to deploy a self-hosted authentication platform with PostgreSQL, Redis, and ClickHouse on your VPS, then verify the dashboard in a browser.

About 8 minutesBrowser verified

Step 1

Open the server Apps tab

Select your VPS, open the Apps tab, and start a new app deployment.

Server Compass Apps tab before creating a Stack Auth app

Step 2

Choose an app template

Click New App and choose the template deployment path so Server Compass can load the built-in catalog.

Choosing to deploy an app from a Server Compass template

Step 3

Search for Stack Auth

Use the template picker search to find Stack Auth.

Searching for Stack Auth in the Server Compass template picker

Step 4

Select the Stack Auth template

Choose the Stack Auth template. Server Compass fills in the API/dashboard service, PostgreSQL, Redis, ClickHouse, and generated secrets.

Stack Auth template selected in Server Compass

Step 5

Review the Stack Auth settings

Confirm the app name and compose services. In this run, the app was named stack-auth-demo and used host port 4248.

Reviewing Stack Auth project settings and compose services

Step 6

Deploy Stack Auth

Review the generated environment values, confirm the port is available, and click Deploy Now.

Reviewing Stack Auth environment variables and port before deployment

Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass pulls the images, starts dependencies, runs migrations, seeds data, and verifies the stack.

Server Compass deploying the Stack Auth template on the VPS

Step 8

Confirm Stack Auth is running

After deployment finishes, return to the Apps tab and confirm the app is marked Running.

Stack Auth template running in the Server Compass Apps tab

Step 9

Open Stack Auth in the browser

Open the application URL in a browser. The dashboard confirms the authentication platform is reachable.

The deployed Stack Auth dashboard loaded in a browser

After Stack Auth Opens

Configure HTTPS and production API/dashboard URLs before using Stack Auth with real applications.
Create or review projects, OAuth providers, domains, and sign-up settings before inviting users.
Back up the PostgreSQL and ClickHouse volumes before relying on production authentication data.

Verified Result

The Stack Auth/Hexclave dashboard loaded successfully in a browser.

Download Server Compass Docs

Stack Auth deployment questions

What does the Stack Auth template deploy?

It deploys the Stack Auth server with PostgreSQL, Redis, and ClickHouse for a self-hosted authentication workspace.

Which port did the tutorial use?

The tutorial used host port 4248, which maps to the Stack Auth dashboard/API service.

Why does the guide stop at the dashboard?

Project setup, OAuth providers, allowed domains, and user settings are specific to the production app you connect.

Should this become a blog post?

No. The deployment guide should live on the Stack Auth template detail page and be linked from the reusable template deployment docs page.

After Deployment

After deploying Stack Auth with Server Compass, complete these steps to finish setup

Visit http://YOUR_SERVER_IP:{{PORT}} and create the super-admin + first project

Update NEXT_PUBLIC_STACK_API_URL via Env Vars to your production URL before going live

Configure OAuth providers (Google, GitHub, etc.) in the dashboard

Install the SDK in your app (`npm install @stackframe/stack`) and paste in the project keys

Test sign-up + sign-in end-to-end before pointing real users at it

Need help? Check out our documentation for detailed guides.

Stack Auth FAQ

Common questions about self-hosting Stack Auth

How do I deploy Stack Auth with Server Compass?

Simply download Server Compass, connect to your VPS, and select Stack Auth from the templates list. Fill in the required configuration and click Deploy. The entire process takes under 3 minutes.

What are the system requirements for Stack Auth?

Stack Auth requires a minimum of 1024MB RAM. We recommend a VPS with at least 2048MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Stack Auth data?

Yes! Server Compass provides volume mapping that allows you to import existing data. You can also use standard Stack Auth backup and restore procedures.

How do I update Stack Auth to the latest version?

Server Compass makes updates easy. Simply click the Update button in your deployment dashboard, and the latest Stack Auth image will be pulled and deployed with zero downtime.

Is Stack Auth free to self-host?

Stack Auth is open-source software. You only pay for your VPS hosting (typically $5-20/month) and optionally Server Compass ($29 one-time). No subscription fees or per-seat pricing.

Related Templates

View all Development

PocketBase

Open-source backend in a single file with realtime database, auth, and file storage

Appwrite

Open-source backend-as-a-service - self-hosted Firebase alternative

Parse Server

Open-source backend framework with dashboard

Supabase

Full Supabase self-hosted with Kong, GoTrue Auth, Realtime, and Studio

Ready to Self-Host Stack Auth?

Download Server Compass and deploy Stack Auth to your VPS in under 3 minutes. No Docker expertise required.

Download Server Compass