---
title: Gitpod
description: How to set up Formbricks in a Gitpod workspace
icon: "code"
---

### Gitpod Setup

<Info>This guide explains how to set up Formbricks in a **Gitpod** workspace.</Info>

**Requirements:**

- A Gitpod workspace with Node.JS, pnpm, and Docker support.

**Steps:**

1. **Open the repository in Gitpod. The workspace typically clones the repo automatically. If not:**

   ```bash
   git clone https://github.com/formbricks/formbricks && cd formbricks
   ```

2. **Setup NodeJS with nvm:**

   ```bash
   nvm install && nvm use
   ```

3. **Install dependencies:**

   ```bash
   pnpm install
   ```

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

   ```bash
   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
   pnpm agents:update
   ```

6. **Run the development setup:**
   ```bash
   pnpm go
   ```

Access the running app via the forwarded port (typically [http://localhost:3000](http://localhost:3000) inside Gitpod).

<Tip>Check your Gitpod settings to ensure Docker is enabled if required.</Tip>
