formbricks-formbricks/docker

Formbricks Quickstart Using Docker

Follow the instructions below to quickly get Formbricks running on your system with Docker. This guide is designed for most users who want a straightforward setup process.

1. Create a New Directory for Formbricks

   Open a terminal and create a new directory for Formbricks, then navigate into this new directory:

   mkdir formbricks-quickstart && cd formbricks-quickstart
   

2. Download the Docker-Compose File

   Download the docker-compose file directly from the Formbricks repository:

   curl -o docker-compose.yml https://raw.githubusercontent.com/formbricks/formbricks/docker/main/docker-compose.yml
   

3. Generate NextAuth Secret

   Next, you need to generate a NextAuth secret. This will be used for session signing and encryption. The sed command below generates a random string using openssl, then replaces the NEXTAUTH_SECRET: placeholder in the docker-compose.yml file with this generated secret:

   sed -i "/NEXTAUTH_SECRET:$/s/NEXTAUTH_SECRET:.\*/NEXTAUTH_SECRET: $(openssl rand -base64 32)/" docker-compose.yml
   

4. Start the Docker Setup

   You're now ready to start the Formbricks Docker setup. The following command will start Formbricks together with a postgreSQL database using Docker Compose:

   docker compose up -d
   

   The -d flag will run the containers in detached mode, meaning they'll run in the background.

5. Visit Formbricks in Your Browser

   After starting the Docker setup, visit http://localhost:3000 in your browser to interact with the Formbricks application. The first time you access this page, you'll be greeted by a setup wizard. Follow the prompts to define your first user and get started.

Enjoy using Formbricks!

Note: For detailed documentation of local setup, take a look at our self hosting docs