---
title: "Deploy Unleash"
description: "Unleash 8.2 feature flag server with Postgres and a ready backend token."
category: "Other"
url: https://railway.com/deploy/unleash-1
---

# Deploy Unleash

Unleash 8.2 feature flag server with Postgres and a ready backend token.

**[Deploy Unleash on Railway](https://railway.com/template/unleash-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/unleash-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Other

## Template content

### unleash https://github.com/Unleash.png

- **Image:** unleashorg/unleash-server:8.2.0
- **Health check:** /health
- **Public domain:** Yes

### Postgres https://devicons.railway.app/i/postgresql.svg

- **Image:** ghcr.io/railwayapp-templates/postgres-ssl:18

## Documentation

# Deploy and Host Unleash on Railway

Unleash is an open-source feature management platform. Teams create feature flags with gradual rollouts, targeting, variants and environments in a web UI, and applications evaluate them locally through official SDKs for Node.js, Java, Go, Python, .NET, Ruby, PHP, Rust and frontend frameworks. Flags change instantly without redeploying.

## About Hosting Unleash

This template deploys Unleash v8.2.0 with a Railway Postgres database. The admin account is `admin` with a password generated at deploy time, so the well-known default password never exists. A backend API token for the `development` environment is created on first start, so an SDK can connect immediately. Database migrations run automatically on boot. Unleash listens on IPv4 and IPv6, so services on the same project can use the private URL. It is light enough for the Hobby plan. Create more tokens and environments in the admin UI. Back up Postgres regularly.

## Common Use Cases

- Gradual rollouts, kill switches and A/B variants for web and mobile apps
- Trunk-based development with flags instead of long-lived branches
- Self-hosted feature flags where data must stay in your own database

## Dependencies for Unleash Hosting

- `unleashorg/unleash-server:8.2.0` (official image)
- Railway Postgres (`ghcr.io/railwayapp-templates/postgres-ssl:18`) with a volume

### Deployment Dependencies

- [Unleash documentation](https://docs.getunleash.io/)
- [Unleash v8.2.0 release](https://github.com/Unleash/unleash/releases/tag/v8.2.0)
- [Unleash SDKs](https://docs.getunleash.io/reference/sdks)
- [Railway private networking](https://docs.railway.com/reference/private-networking)

### Implementation Details

| Service | Image | Networking | Storage |
| --- | --- | --- | --- |
| unleash | `unleashorg/unleash-server:8.2.0` | public domain on 4242; private IPv4/IPv6 | none (state in Postgres) |
| Postgres | Railway Postgres 18 | private only | volume |

Node.js SDK from another Railway service:

```js
const unleash = initialize({
  url: process.env.UNLEASH_API_URL,          // ${{unleash.UNLEASH_PRIVATE_API_URL}}
  appName: "my-app",
  customHeaders: { Authorization: process.env.UNLEASH_TOKEN }, // ${{unleash.INIT_BACKEND_API_TOKENS}}
});
```

| Variable | Default | Purpose |
| --- | --- | --- |
| `UNLEASH_DEFAULT_ADMIN_USERNAME` / `_PASSWORD` | `admin` / generated | First admin login |
| `INIT_BACKEND_API_TOKENS` | `default:development.` | Backend SDK token created on first start |
| `DATABASE_URL` | `${{Postgres.DATABASE_URL}}` | Database |

Notes:

- `INIT_*_API_TOKENS` only create tokens when the database has none; change tokens in the UI afterwards.
- Frontend SDKs need a frontend token; create one in the admin UI and set `UNLEASH_FRONTEND_API_ORIGINS` if needed.

This is a community-maintained deployment package and does not imply affiliation with or endorsement by the Unleash project or its maintainers.

## Why Deploy Unleash on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying Unleash on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.


## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/unleash-1