Back to all templates
Unleash logo

Unleash

Development768MB+ RAM

Open-source feature management and experimentation platform with Postgres

developmentdevtoolsunleashopen-sourceself-hosteddocker

Deploy Unleash in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Unleash

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Unleash on a VPS with Server Compass

Use the Unleash template in Server Compass to deploy a self-hosted feature management and experimentation platform on your VPS, then verify the login page loads.

About 10 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select the tutorial-vps VPS, open the Apps tab, and start a new app deployment. Keep sensitive server details hidden before capturing or sharing screenshots.

Server Compass Apps tab before creating a Unleash app
2
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
3
Step 3

Search for Unleash

Use the template picker search to find Unleash in the Server Compass template catalog.

Searching for Unleash in the Server Compass template picker
4
Step 4

Select the Unleash template

Choose the Unleash template. Server Compass fills the Unleash service, PostgreSQL service, database password, initial admin API token, and public web port.

Unleash template selected in Server Compass
5
Step 5

Review the Unleash settings

Confirm the app name and compose service. In this run, the app was named unleash-demo and used host port 4066.

Reviewing Unleash project settings and compose service
6
Step 6

Deploy Unleash

Review the generated compose settings, confirm the Unleash web port is available, and click Deploy.

Reviewing Unleash web port before deployment
7
Step 7

Watch the deployment progress

Keep the deployment modal open while Server Compass uploads the compose file, pulls the Unleash image, starts the container, and verifies the stack.

Server Compass deploying the Unleash template on the VPS
8
Step 8

Confirm Unleash is running

After deployment finishes, return to the Apps tab and confirm the Unleash app is marked Running with its application URL available.

Unleash template running in the Server Compass Apps tab
9
Step 9

Open Unleash in the browser

Open the application URL in a browser. The Unleash login page confirms the feature flag platform is reachable. Change the default administrator password before production use.

The deployed Unleash web UI loaded in a browser

After Unleash Opens

  • Log in with the initial administrator account and change the default password immediately.
  • Use HTTPS before connecting production SDK clients.
  • Back up the Unleash PostgreSQL volume because it stores projects, environments, flags, and identities.
  • Create separate Development and Production environments before shipping flags.
  • Keep the initial admin API token private and use least-privilege environment keys in applications.
  • Restrict administrative access with a reverse proxy, VPN, or firewall for production use.
  • Keep the Unleash image updated for platform and dependency fixes.

Verified Result

The Unleash web interface loaded successfully from the deployed container.

Unleash deployment questions

What does the Unleash template deploy?

It deploys Unleash with PostgreSQL for self-hosted feature flags, projects, environments, and segments.

Which port did the tutorial use?

The tutorial used host port 4066, which maps to the Unleash web UI inside the container on the same generated port.

Does Unleash need setup after deployment?

Yes. Log in with the initial administrator account, change the default password, create a project and environments, then create a harmless test flag before connecting production SDKs.

Should this become a blog post?

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

After Deployment

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

1

Visit the application URL

2

Log in as admin / unleash4all and change the password

3

Create projects and feature toggles

4

Use *:*.INIT_ADMIN_API_TOKEN as Bearer token in your SDK config

Need help? Check out our documentation for detailed guides.

Unleash FAQ

Common questions about self-hosting Unleash

How do I deploy Unleash with Server Compass?

Simply download Server Compass, connect to your VPS, and select Unleash 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 Unleash?

Unleash requires a minimum of 768MB RAM. We recommend a VPS with at least 1536MB RAM for optimal performance. Any modern Linux server with Docker support will work.

Can I migrate my existing Unleash data?

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

How do I update Unleash to the latest version?

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

Is Unleash free to self-host?

Unleash 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.

Ready to Self-Host Unleash?

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

Download Server Compass