Skip to main content

Local Machine Setup - Linux

This guide is recommended for advanced users setting up Formbricks on a Linux machine.
Here are the requirements for setting up Formbricks on Linux:
  • Node.JS (v20 recommended)
  • pnpm
  • Docker (to run PostgreSQL/MailHog)
Steps:
  1. Clone the repository and move into the directory:
  2. Setup NodeJS with nvm:
  3. Install NodeJS packages via pnpm:
  4. Create a development .env file and generate the required secrets:
  5. Generate the Next.js AGENTS.md file (optional, for AI-assisted development): This step generates an AGENTS.md file at the repository root that provides Next.js documentation context for AI coding assistants (e.g. Cursor, GitHub Copilot). It runs npx @next/codemod agents-md under the hood. Re-run it whenever you upgrade Next.js.
  6. Start the development setup:
You can now access Formbricks at http://localhost:3000.
Create a new account on first login as no default account is available.