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 repository and change directory:
  2. Setup NodeJS with nvm:
  3. Install NodeJS packages with 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:
Visit http://localhost:3000 to access Formbricks.
Ensure you create a new account at first login.