Skip to main content

​
Local Machine Setup - Windows

This guide is intended for Windows users. For the best experience, use WSL2 since pure Windows is not fully supported.
Requirements:
  • Node.JS (v20 recommended) via WSL2
  • pnpm
  • Docker (ensure Docker Desktop is installed with WSL2 integration enabled)
Steps (Using WSL2):
  1. Open your WSL2 terminal and clone the repository:
  2. Setup NodeJS with nvm in WSL2:
  3. Install packages using 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:
Access Formbricks at http://localhost:3000.
If you run into conflicts, ensure any local services (like PostgreSQL) are stopped.