Last Updated: 1/28/2026

Dev Environment Setup

Get your local environment running.

Prerequisites

Node.js 20+
Docker Desktop
Git

Quick Start


# Clone the monorepo
git clone git@github.com:acme-internal/monorepo.git
cd monorepo
 
# Run setup script
./scripts/setup-dev.sh
 
# Start services
docker-compose up -d
 
# Start dev server
npm run dev

Environment Variables

Copy the example env file:


cp .env.example .env

Required variables:

Variable	Description
`DATABASE_URL`	PostgreSQL connection
`REDIS_URL`	Redis connection
`API_KEY`	Local dev API key

Troubleshooting

Port conflicts


# Check what's using port 3000
lsof -i :3000

Docker issues


# Reset everything
docker-compose down -v
docker-compose up -d