> ## Documentation Index
> Fetch the complete documentation index at: https://formbricks.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mac

> How to set up Formbricks on a Mac machine

### Local Machine Setup - Mac

<Info>This guide is recommended for advanced users setting up Formbricks on a **Mac** machine.</Info>

**Requirements:**

* Node.JS (v20 recommended)
* [pnpm](https://pnpm.io/)
* [Docker](https://www.docker.com/)

**Steps:**

1. **Clone the project & change directory:**

   ```bash theme={null}
   git clone https://github.com/formbricks/formbricks && cd formbricks
   ```

2. **Setup NodeJS with nvm:**

   ```bash theme={null}
   nvm install && nvm use
   ```

3. **Install NodeJS packages with pnpm:**

   ```bash theme={null}
   pnpm install
   ```

4. **Create a development `.env` file and generate the required secrets:**

   ```bash theme={null}
   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.

   ```bash theme={null}
   pnpm agents:update
   ```

6. **Start the development setup:**
   ```bash theme={null}
   pnpm go
   ```

Visit [http://localhost:3000](http://localhost:3000) to access Formbricks.

<Tip>Ensure you create a new account at first login.</Tip>