Back to all templates
Formbricks logo

Formbricks

Application512MB+ RAM

Open-source survey and feedback platform

surveysfeedbackforms

Deploy Formbricks in 3 Steps

1

Connect Your VPS

Add your server credentials to Server Compass

2

Select Formbricks

Choose from our template library

3

Deploy & Configure

Fill in settings and click Deploy

No Docker knowledge required
Step-by-step deployment guide

Deploy Formbricks on a VPS with Server Compass

Use the Formbricks template in Server Compass to deploy a self-hosted open-source survey and feedback platform with PostgreSQL on your VPS, then verify the Formbricks web UI in a browser.

About 7 minutesBrowser verified
1
Step 1

Open the server Apps tab

Select your 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 Formbricks 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 Formbricks

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

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

Select the Formbricks template

Choose the Formbricks template. Server Compass fills the Formbricks image, host port, public URL, generated secrets, and PostgreSQL data volume.

Formbricks template selected in Server Compass
5
Step 5

Review the Formbricks settings

Confirm the app name and compose services. In this run, the app was named formbricks-demo and used host port 3001.

Reviewing Formbricks project settings and compose services
6
Step 6

Deploy Formbricks

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

Reviewing Formbricks environment variables and port before deployment
7
Step 7

Watch the deployment progress

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

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

Confirm Formbricks is running

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

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

Open Formbricks in the browser

Open the application URL in a browser. The Formbricks web UI confirms the site is reachable.

The deployed Formbricks web UI loaded in a browser

After Formbricks Opens

  • Create the first Formbricks account before production use.
  • Configure surveys, HTTPS, email, and user access before production use.
  • Add a domain and HTTPS before exposing the survey dashboard to users.
  • Back up the Formbricks PostgreSQL volume before relying on it for production surveys.

Verified Result

The Formbricks web UI loaded successfully in a browser.

Formbricks deployment questions

What does the Formbricks template deploy?

It deploys Formbricks with PostgreSQL backing services plus persistent database volumes.

Which port did the tutorial use?

The tutorial used host port 3001, which maps to the Formbricks web server inside the container on the same port.

Why does the guide stop at the first-run web UI?

The tutorial verifies the clean first-run web UI because real surveys, users, integrations, and access rules depend on the production server.

Should this become a blog post?

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

Do It Yourself

Deploy Formbricks via Command Line

Prefer the command line? Follow this step-by-step guide to deploy Formbricks manually on your VPS.

1

Start a Secure Shell Session

Open your terminal and connect to your server. Replace the IP address with your VPS IP.

terminal
# SSH into your server
ssh root@your-server-ip

# Using a custom SSH key
ssh -i ~/.ssh/id_rsa root@your-server-ip

First time? Need Docker? Install it: curl -fsSL https://get.docker.com | sh

2

Prepare Your Workspace

Set up a clean directory for your application.

terminal
# Create and navigate to project directory
mkdir -p ~/apps/formbricks
cd ~/apps/formbricks
3

Set Up Container Configuration

Set up the container stack using this Docker Compose configuration:

docker-compose.yml
services:
  formbricks:
    image: formbricks/formbricks:latest
    ports:
      - "3000:3000"
    environment:
      - DATABASE_URL=postgresql://formbricks:<your-db-password>@db:5432/formbricks
      - NEXTAUTH_SECRET=<your-nextauth-secret>
      - NEXTAUTH_URL=<your-nextauth-url>
      - ENCRYPTION_KEY=<your-encryption-key>
    restart: unless-stopped
    depends_on:
      - db

  db:
    image: pgvector/pgvector:pg16
    environment:
      - POSTGRES_USER=formbricks
      - POSTGRES_PASSWORD=<your-db-password>
      - POSTGRES_DB=formbricks
    volumes:
      - postgres_data:/var/lib/postgresql/data
    restart: unless-stopped

volumes:
  postgres_data:
Configuration Variables
PORTHost port(default: 3000)
NEXTAUTH_URLPublic URL
NEXTAUTH_SECRETNextAuth secret
ENCRYPTION_KEYEncryption key
DB_PASSWORDDB password
4

Bring Up the Application

Launch your application stack in the background.

terminal
# Start the containers in detached mode
docker compose up -d

# Check if containers are running
docker compose ps

# View logs
docker compose logs -f
5

Configure Firewall

Configure your firewall to permit external connections.

terminal
# Allow the application port through firewall
sudo ufw allow 3000/tcp
sudo ufw reload

# Access your app at:
# http://your-server-ip:3000
Skip the Terminal

Prefer a visual interface? Use Server Compass.

Deploy Formbricks with a beautiful UI instead. No SSH, no YAML editing, no terminal commands. Just click, configure, and deploy in under 3 minutes.

  • Visual configuration UI
  • One-click deployment
  • Automatic SSL setup
  • Zero-downtime updates
  • Built-in monitoring
  • One-click rollbacks
Download Server Compass$29 one-time • Lifetime license

After Deployment

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

1

Create account

2

Create surveys

Need help? Check out our documentation for detailed guides.

Formbricks FAQ

Common questions about self-hosting Formbricks

How do I deploy Formbricks with Server Compass?

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

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

Can I migrate my existing Formbricks data?

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

How do I update Formbricks to the latest version?

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

Is Formbricks free to self-host?

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

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

Download Server Compass