Self Host Formbricks Production Instance
Follow this guide to get your Formbricks instance up and running with a Postgres DB and SSL certificate using a single script:
Requirements
Before you proceed, make sure you have the following:
-
A Linux Ubuntu Virtual Machine deployed with SSH access.
-
An A record set up to connect a custom domain to your instance. Formbricks will automatically create an SSL certificate for your domain using Let's Encrypt.
Single Command Setup
Copy and paste the following command into your terminal:
/bin/sh -c "$(curl -fsSL https://raw.githubusercontent.com/formbricks/formbricks/stable/docker/formbricks.sh)"
The script will prompt you for the following information:
-
Overwriting Docker GPG Keys: If Docker GPG keys already exist, the script will ask if you want to overwrite them.
-
Email Address: Provide your email address for SSL certificate registration with Let's Encrypt.
-
Domain Name: Enter the domain name that Traefik will use to create the SSL certificate and forward requests to Formbricks.
That's it! After running the command and providing the required information, visit the domain name you entered, and you should see the Formbricks home wizard!
Formbricks Hub
The stack includes the Formbricks Hub API (ghcr.io/formbricks/hub). Hub shares the same database as Formbricks by default.
- Migrations: A
hub-migrateservice runs Hub's database migrations (goose + river) before the Hub API starts. It runs on everydocker compose upand is idempotent. - Production (
docker/docker-compose.yml): SetHUB_API_KEY(required).HUB_API_URLdefaults tohttp://hub:8080so the Formbricks app can reach Hub inside the compose network. OverrideHUB_DATABASE_URLonly if you want Hub to use a separate database. - Development (
docker-compose.dev.yml): Hub uses the same Postgres database;HUB_API_KEYdefaults todev-api-key(override withHUB_API_KEY) and the local Hub URL ishttp://localhost:8080.
In development, Hub is exposed locally on port 8080. In production Docker Compose, Hub stays internal to the compose network and is reached via http://hub:8080.