What are the installation steps for GrowthPilot?

Install

1. Download the ZIP from your DEV3 account and unzip it. Open Documentation/index.html in a browser for the full guide.

2. Copy the environment template and fill it in:

   cp .env.example .env.local

   Set MONGODB_URI and MONGODB_DB, and random values for AUTH_SECRET, CRON_SECRET and FIELD_ENCRYPTION_KEY. The file explains the optional email, Meta, LinkedIn, Cloudinary, AI and cache settings.

3. Install the dependencies (.npmrc sets legacy-peer-deps) and seed the demo organisation (about 280 leads, pools, campaigns and workflows; it never calls a paid API):

   npm install
   npm run seed

4. Start the app with simulated channels, and the worker in a second terminal:

   CHANNELS_SIMULATE=1 npm run dev
   npm run dev:worker

   Open the address the app prints and sign in with one of the seeded demo accounts.

Production

• Docker: docker compose up -d --build starts MongoDB, the app and the worker. Seed with docker compose --profile tools run --rm seed.
• PM2: npm run build, then pm2 start ecosystem.config.js starts the app and the worker.
• Vercel: set the environment variables; vercel.json calls /api/cron/tick every minute (a per-minute cron needs Vercel Pro; on Hobby, run the worker elsewhere).
• Run npm run db:indexes once against a new database.
• npm run verify runs the typecheck, lint, static checks and tests.