Back to all templates
Flagsmith logo

Flagsmith

Development1024MB+ RAM

Open-source feature flag and remote config service with environments, segments, percentage rollouts, and A/B tests

developmentdevtoolsflagsmithopen-sourceself-hosteddocker

Deploy Flagsmith in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Flagsmith

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Flagsmith on a VPS with Server Compass

Use the Flagsmith template in Server Compass to deploy a self-hosted feature flag platform on your VPS, then verify the sign-up 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 Flagsmith 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 Flagsmith

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

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

Select the Flagsmith template

Choose the Flagsmith template. Server Compass fills the Flagsmith service, PostgreSQL service, database password, and public web port.

Flagsmith template selected in Server Compass
5
Step 5

Review the Flagsmith settings

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

Reviewing Flagsmith project settings and compose service
6
Step 6

Deploy Flagsmith

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

Reviewing Flagsmith 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 Flagsmith image, starts the container, and verifies the stack.

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

Confirm Flagsmith is running

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

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

Open Flagsmith in the browser

Open the application URL in a browser. The Flagsmith sign-up page confirms the feature flag platform is reachable.

The deployed Flagsmith web UI loaded in a browser

After Flagsmith Opens

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

Verified Result

The Flagsmith web interface loaded successfully from the deployed container.

Flagsmith deployment questions

What does the Flagsmith template deploy?

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

Which port did the tutorial use?

The tutorial used host port 4129, which maps to the Flagsmith web UI on container port 8000.

Does Flagsmith need setup after deployment?

Sign up as the first admin, 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 Flagsmith template detail page and be linked from the reusable template deployment docs page.

After Deployment

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

1

Visit the application URL and sign up to create the initial admin organization

2

Create a project and at least one environment (Development, Production)

3

Create feature flags and copy the environment API key into your application SDK

4

Configure segments and percentage rollouts for gradual feature releases

Need help? Check out our documentation for detailed guides.

Flagsmith FAQ

Common questions about self-hosting Flagsmith

How do I deploy Flagsmith with Server Compass?

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

Flagsmith 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 Flagsmith data?

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

How do I update Flagsmith to the latest version?

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

Is Flagsmith free to self-host?

Flagsmith 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 Flagsmith?

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

Download Server Compass