---
title: "Deploy SuperTokens Core Auth"
description: "SuperTokens auth core on PostgreSQL with a required, generated API key"
category: "Authentication"
url: https://railway.com/deploy/supertokens-core-auth
---

# Deploy SuperTokens Core Auth

SuperTokens auth core on PostgreSQL with a required, generated API key

**[Deploy SuperTokens Core Auth on Railway](https://railway.com/template/supertokens-core-auth)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/supertokens-core-auth/manifest.json

- **Creator:** Anton Orel's Projects
- **Category:** Authentication
- **Total deploys:** 2

## Template content

### SuperTokens

- **Image:** supertokens/supertokens-postgresql:12.5.0@sha256:4e71d8c110193535841d0d3c5fc1725de6e3862d393c3ef98e1c6f0f9645d026
- **Start command:** `/bin/bash -ec "printf %s 'IyEvYmluL2Jhc2gKIyBTdGFydCBjb250cmFjdCBmb3IgdGhlIFN1cGVyVG9rZW5zIHNlcnZpY2UgKG9mZmljaWFsIHN1cGVydG9rZW5zLXBvc3RncmVzcWwKIyBpbWFnZSkuIFJlZnVzZXMgdG8gc3RhcnQgd2l0aG91dCBhIHVzYWJsZSBBUEkga2V5LCB3YWl0cyBmb3IgUG9zdGdyZVNRTCwKIyByZW1vdmVzIHRoZSBlbnRlcnByaXNlICgiZWUiKSBtb2R1bGUgc28gb25seSB0aGUgQXBhY2hlLTIuMCBjb3JlIHJ1bnMsIGFuZAojIGV4ZWNzIHRoZSBjb3JlJ3MgSlZNIGFzIFBJRCAxIHNvIFJhaWx3YXkncyBTSUdURVJNIHJlYWNoZXMgaXQuIFByaW50cyBubwojIGNyZWRlbnRpYWwuCnNldCAtZXVvIHBpcGVmYWlsCmV4cG9ydCBMQ19BTEw9QwoKaW5zdGFsbF9kaXI9L3Vzci9saWIvc3VwZXJ0b2tlbnMKbG9nKCkgeyBwcmludGYgJ1tzdXBlcnRva2Vucy1zdGFydF0gJXNcbicgIiQqIiA+JjI7IH0KcmVmdXNlKCkgeyBsb2cgIlN1cGVyVG9rZW5zIHJlZnVzZWQgdG8gc3RhcnQ6ICQqIjsgZXhpdCA2NDsgfQoKIyBFdmVyeSBjb3JlIEFQSSBleGNlcHQgaGVhbHRoLCBKV0tTIGFuZCB0aGUgYnJvd3Nlci1mYWNpbmcgU0FNTCByb3V0ZXMgaXMgb3BlbgojIHRvIGFueW9uZSB3aGVuIEFQSV9LRVlTIGlzIGVtcHR5LCBzbyBhbiBlbXB0eSBvciBtYWxmb3JtZWQgdmFsdWUgbXVzdCBzdG9wIHRoZQojIHNlcnZpY2UuIFRoZSBjb3JlIGl0c2VsZiBhY2NlcHRzIDIwIGNoYXJhY3RlcnM7IHRoaXMgdGVtcGxhdGUgYXNrcyBmb3IgMzIuCiMgTGV0dGVycywgZGlnaXRzLCAnPScgYW5kICctJyBvbmx5ICh0aGUgY29yZSdzIG93biBhbHBoYWJldCksIGNvbW1hLXNlcGFyYXRlZCwKIyBubyBzcGFjZXMsIGFuZCBubyBxdW90ZXMsIHdoaWNoIHRoZSBjb3JlIHdvdWxkIHVuZXNjYXBlLgprZXlzPSIke0FQSV9LRVlTOi19IgprZXlfcGF0dGVybj0nXltBLVphLXowLTk9LV17MzIsfSgsW0EtWmEtejAtOT0tXXszMix9KSokJwpbWyAtbiAiJHtrZXlzfSIgXV0gfHwgcmVmdXNlICJBUElfS0VZUyBtdXN0IGJlIHNldC4gU2V0IG9uZSBvciBtb3JlIGtleXMgb2YgMzIgb3IgbW9yZSBsZXR0ZXJzLCBkaWdpdHMsICc9JyBvciAnLScsIHNlcGFyYXRlZCBieSBjb21tYXMuIgpbWyAiJHtrZXlzfSIgPX4gJHtrZXlfcGF0dGVybn0gXV0gXAogIHx8IHJlZnVzZSAiQVBJX0tFWVMgbXVzdCBiZSBvbmUgb3IgbW9yZSBrZXlzIG9mIDMyIG9yIG1vcmUgbGV0dGVycywgZGlnaXRzLCAnPScgb3IgJy0nLCBzZXBhcmF0ZWQgYnkgY29tbWFzIHdpdGhvdXQgc3BhY2VzLiIKCnVyaT0iJHtQT1NUR1JFU1FMX0NPTk5FQ1RJT05fVVJJOi19IgpbWyAtbiAiJHt1cml9IiBdXSB8fCByZWZ1c2UgIlBPU1RHUkVTUUxfQ09OTkVDVElPTl9VUkkgbXVzdCBiZSBzZXQgdG8gdGhlIFBvc3RncmVTUUwgY29ubmVjdGlvbiBVUkkuIgojIFRoZSBkYXRhYmFzZSBtdXN0IGNvbWUgZnJvbSBQT1NUR1JFU1FMX0NPTk5FQ1RJT05fVVJJIGFsb25lLCBzbyBhIHN0cmF5CiMgUE9TVEdSRVNRTF9IT1NUIGNhbm5vdCBzaWxlbnRseSBwb2ludCB0aGUgY29yZSBzb21ld2hlcmUgZWxzZS4KZm9yIG5hbWUgaW4gUE9TVEdSRVNRTF9IT1NUIFBPU1RHUkVTUUxfUE9SVCBQT1NUR1JFU1FMX1VTRVIgUE9TVEdSRVNRTF9QQVNTV09SRCBQT1NUR1JFU1FMX1BBU1NXT1JEX0ZJTEUgUE9TVEdSRVNRTF9EQVRBQkFTRV9OQU1FOyBkbwogIFtbIC16ICIkeyFuYW1lOi19IiBdXSB8fCByZWZ1c2UgIiR7bmFtZX0gaXMgc2V0OyBjb25maWd1cmUgdGhlIGRhdGFiYXNlIG9ubHkgdGhyb3VnaCBQT1NUR1JFU1FMX0NPTk5FQ1RJT05fVVJJLiIKZG9uZQoKIyBSYWlsd2F5IHJvdXRlcyBpdHMgZG9tYWluIGFuZCBoZWFsdGggY2hlY2sgdG8gUE9SVDsgdGhlIGNvcmUgcmVhZHMKIyBTVVBFUlRPS0VOU19QT1JULCBzbyB0aGUgd3JhcHBlciBzZXRzIGl0IGZyb20gUE9SVC4KcG9ydD0iJHtQT1JUOi0zNTY3fSIKW1sgIiR7cG9ydH0iID1+IF5bMS05XVswLTldezAsNH0kIF1dICYmICgoIHBvcnQgPD0gNjU1MzUgKSkgfHwgcmVmdXNlICJQT1JUIG11c3QgYmUgYSBUQ1AgcG9ydCBudW1iZXIuIgpbWyAteiAiJHtTVVBFUlRPS0VOU19QT1JUOi19IiB8fCAiJHtTVVBFUlRPS0VOU19QT1JUfSIgPT0gIiR7cG9ydH0iIF1dIFwKICB8fCByZWZ1c2UgIlNVUEVSVE9LRU5TX1BPUlQgZGlmZmVycyBmcm9tIFBPUlQ7IHNldCBvbmx5IFBPUlQuIgpleHBvcnQgU1VQRVJUT0tFTlNfUE9SVD0iJHtwb3J0fSIKCmhlYXA9IiR7U1VQRVJUT0tFTlNfSkFWQV9IRUFQX01COi0zODR9IgpbWyAiJHtoZWFwfSIgPX4gXlsxLTldWzAtOV17Miw0fSQgXV0gJiYgKCggaGVhcCA+PSAxMjggJiYgaGVhcCA8PSAxNjM4NCApKSBcCiAgfHwgcmVmdXNlICJTVVBFUlRPS0VOU19KQVZBX0hFQVBfTUIgbXVzdCBiZSBhIHdob2xlIG51bWJlciBvZiBtZWdhYnl0ZXMgZnJvbSAxMjggdG8gMTYzODQuIgoKIyBXYWl0IGZvciBQb3N0Z3JlU1FMOiB0aGUgY29yZSBleGl0cyBvbiBpdHMgZmlyc3QgcmVmdXNlZCBjb25uZWN0aW9uLCBhbmQKIyBSYWlsd2F5IHN0YXJ0cyBzZXJ2aWNlcyBpbiBhbnkgb3JkZXIuCnVyaV9wYXR0ZXJuPSdecG9zdGdyZXMocWwpPzovL1teQC9dKkAoXFtbMC05QS1GYS1mOi5dK1xdfFtBLVphLXowLTkuLV0rKSg6KFswLTldezEsNX0pKT8oL3wkKScKaWYgW1sgIiR7dXJpfSIgPX4gJHt1cmlfcGF0dGVybn0gXV07IHRoZW4KICBob3N0PSIke0JBU0hfUkVNQVRDSFsyXX0iOyBob3N0PSIke2hvc3QjW30iOyBob3N0PSIke2hvc3QlXX0iOyBkYl9wb3J0PSIke0JBU0hfUkVNQVRDSFs0XTotNTQzMn0iCiAgZGVhZGxpbmU9JCgoU0VDT05EUyArIDE4MCkpCiAgbG9nICJXYWl0aW5nIGZvciBQb3N0Z3JlU1FMIGF0ICR7aG9zdH06JHtkYl9wb3J0fS4iCiAgdW50aWwgdGltZW91dCAzIGJhc2ggLWMgJ2V4ZWMgMzw+Ii9kZXYvdGNwLyQwLyQxIicgIiR7aG9zdH0iICIke2RiX3BvcnR9IiAyPi9kZXYvbnVsbDsgZG8KICAgICgoIFNFQ09ORFMgPCBkZWFkbGluZSApKSB8fCB7IGxvZyAiUG9zdGdyZVNRTCBhdCAke2hvc3R9OiR7ZGJfcG9ydH0gZGlkIG5vdCBhY2NlcHQgY29ubmVjdGlvbnMgaW4gdGltZS4iOyBleGl0IDE7IH0KICAgIHNsZWVwIDIKICBkb25lCiAgbG9nICJQb3N0Z3JlU1FMIGF0ICR7aG9zdH06JHtkYl9wb3J0fSBhY2NlcHRzIGNvbm5lY3Rpb25zLiIKZWxzZQogIGxvZyAiQ291bGQgbm90IHJlYWQgYSBob3N0IGZyb20gUE9TVEdSRVNRTF9DT05ORUNUSU9OX1VSSTsgc3RhcnRpbmcgd2l0aG91dCB3YWl0aW5nIGZvciBQb3N0Z3JlU1FMLiIKZmkKCiMgT25seSB0aGUgQXBhY2hlLTIuMCBjb3JlOiB0aGUgZWUgbW9kdWxlIGlzIGxpY2Vuc2VkIGZvciBwcm9kdWN0aW9uIHVzZSBvbmx5CiMgd2l0aCBhIFN1cGVyVG9rZW5zIHN1YnNjcmlwdGlvbi4gVGhlIGNvcmUgdHJlYXRzIGEgbWlzc2luZyBtb2R1bGUgYXMgIm5vIHBhaWQKIyBmZWF0dXJlcyIuIEZhaWwgY2xvc2VkIGlmIGl0IGNhbm5vdCBiZSByZW1vdmVkLgpybSAtZiAiJHtpbnN0YWxsX2Rpcn0iL2VlLyouamFyCmlmIGNvbXBnZW4gLUcgIiR7aW5zdGFsbF9kaXJ9L2VlLyouamFyIiA+L2Rldi9udWxsOyB0aGVuCiAgcmVmdXNlICJjb3VsZCBub3QgcmVtb3ZlIHRoZSBlbnRlcnByaXNlIG1vZHVsZSBmcm9tICR7aW5zdGFsbF9kaXJ9L2VlLiIKZmkKCnRlbXBfZGlyPSIke2luc3RhbGxfZGlyfS90ZW1wLyIKbWtkaXIgLXAgIiR7dGVtcF9kaXJ9Igpsb2cgIlN0YXJ0aW5nIFN1cGVyVG9rZW5zIGNvcmUgd2l0aCBhICR7aGVhcH0gTUIgaGVhcC4iCiMgVGhlIGltYWdlJ3MgbGF1bmNoZXIgKGBzdXBlcnRva2VucyBzdGFydGApIHJ1bnMgdGhlIGNvcmUgYXMgYSBjaGlsZCBvZiBhCiMgc2hlbGwgdGhhdCBpZ25vcmVzIFNJR1RFUk0gYXMgUElEIDEsIHNvIGEgc3RvcCB3YWl0cyBmb3IgU0lHS0lMTC4gUnVuIHRoZQojIHNhbWUgSlZNIGNvbW1hbmQgaXQgYnVpbGRzLCBkaXJlY3RseS4KZXhlYyAiJHtpbnN0YWxsX2Rpcn0vanJlL2Jpbi9qYXZhIiBcCiAgLURqYXZhLnNlY3VyaXR5LmVnZD1maWxlOi9kZXYvdXJhbmRvbSBcCiAgIi1EamF2YS5pby50bXBkaXI9JHt0ZW1wX2Rpcn0iIFwKICAiLVhteCR7aGVhcH1NIiBcCiAgLVhYOitFeGl0T25PdXRPZk1lbW9yeUVycm9yIFwKICAtY2xhc3NwYXRoICIke2luc3RhbGxfZGlyfS9jb3JlLyo6JHtpbnN0YWxsX2Rpcn0vcGx1Z2luLWludGVyZmFjZS8qIiBcCiAgaW8uc3VwZXJ0b2tlbnMuTWFpbiAiJHtpbnN0YWxsX2Rpcn0vIiBcCiAgImNvbmZpZ0ZpbGU9JHtpbnN0YWxsX2Rpcn0vY29uZmlnLnlhbWwiIFwKICAidGVtcERpckxvY2F0aW9uPSR7dGVtcF9kaXJ9Igo=' | base64 -d >/tmp/supertokens-start.sh; exec /bin/bash /tmp/supertokens-start.sh"`
- **Health check:** /hello
- **Public domain:** Yes

### PostgreSQL

- **Image:** postgres:18.7-alpine@sha256:ff64c9e3bdf8e2120107d3559de8db314e8305f7e38c5105903c6295876738ff

## Documentation

# Deploy and Host SuperTokens Core Auth on Railway

SuperTokens is open-source authentication. Its core service stores users, password hashes and sessions, and your backend calls it through a SuperTokens SDK for Node.js, Python or Go to sign users up and in (email and password, passwordless codes, social providers) and to create, verify, refresh and revoke sessions.

## About Hosting SuperTokens Core Auth

The template runs SuperTokens core 12.5.0 from the official `supertokens/supertokens-postgresql` image and PostgreSQL 18, both pinned by digest. PostgreSQL is private and keeps everything on a 5 GB volume; the core is public over HTTPS so a backend anywhere can reach it, or a backend in the same project can use the private address. Every core API except health checks and the public signing keys requires the generated API key, and the core refuses to start without one, so no deployment runs an open auth server. The template runs only the Apache-2.0 core; SuperTokens' paid features (account linking, multi-tenancy, MFA, SAML, OAuth2 provider) stay disabled.

## Why Deploy SuperTokens Core Auth on Railway

Railway gives the core an HTTPS domain, private networking to PostgreSQL, a persistent volume, generated secrets and health-checked deploys. The core reconnects to PostgreSQL after restarts, and users, sessions and signing keys survive redeploys because they live in the database.

## Common Use Cases

- Add email and password, passwordless or social sign-in to a web or mobile app without a hosted auth vendor
- Run session management (rotating refresh tokens, revocation) for an API backend
- Self-host the auth core for staging or a small production app while keeping user data in your own database

## Dependencies for SuperTokens Core Auth Hosting

The deployment uses [SuperTokens](https://supertokens.com) core ([source](https://github.com/supertokens/supertokens-core)) and [PostgreSQL](https://www.postgresql.org).

### Deployment Dependencies

- SuperTokens core 12.5.0 with its PostgreSQL plugin
- PostgreSQL 18 with a 5 GB Railway volume
- A backend that uses a SuperTokens SDK, configured with the core's URL and the `API_KEYS` value from the SuperTokens service variables


## Similar templates

- [Keycloak](https://railway.com/deploy/mSwigX) — [2026-11-04] Keycloak with keywind theme + Apple & Discord providers
- [lua-protector](https://railway.com/deploy/lua-protector) — Test deployed my project first
- [bknd](https://railway.com/deploy/p4nTYL) — Feature-rich yet lightweight backend

Open this page in a browser: https://railway.com/deploy/supertokens-core-auth
