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 project & move into the directory:
    git clone https://github.com/formbricks/formbricks && cd formbricks
    
  2. Setup NodeJS with nvm:
    nvm install && nvm use
    
  3. Install NodeJS packages via pnpm:
    pnpm install
    
  4. Create a development .env file and generate the required secrets:
    pnpm dev:setup
    
  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.
    pnpm agents:update
    
  6. Start the development setup:
    pnpm go
    
You can now access Formbricks at http://localhost:3000.
Create a new account on first login as no default account is available.