Skip to main content

​
Local Machine Setup - Mac

This guide is recommended for advanced users setting up Formbricks on a Mac machine.
Requirements: Steps:
  1. Clone the project & change directory: 
    git clone https://github.com/formbricks/formbricks && cd formbricks
  2. Setup NodeJS with nvm: 
    nvm install && nvm use
  3. Install NodeJS packages with pnpm: 
    pnpm install
  4. Create a .env file from the example: 
    cp .env.example .env
  5. Generate & set secret values (using BSD sed syntax for macOS): 
    sed -i '' '/^ENCRYPTION_KEY=/s|.*|ENCRYPTION_KEY='$(openssl rand -hex 32)'|' .env
sed -i '' '/^NEXTAUTH_SECRET=/s|.*|NEXTAUTH_SECRET='$(openssl rand -hex 32)'|' .env
sed -i '' '/^CRON_SECRET=/s|.*|CRON_SECRET='$(openssl rand -hex 32)'|' .env
  6. 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
  7. Start the development setup: 
    pnpm go
Visit http://localhost:3000 to access Formbricks.
Ensure you create a new account at first login.