Installation

Detailed setup guide

Installation

Detailed installation for local development and evaluation.


System Requirements

ComponentRequirement
Node.js22.x or 24.x
Package managerpnpm 9+
DatabasePostgreSQL 16+ (via Docker)
CacheRedis 7+ (via Docker)
OSmacOS, Linux, or WSL2

Step-by-Step

1. Clone the repository

git clone https://github.com/TheDotProtocol/grayscaleproject.git
cd grayscaleproject

2. Configure environment

cp .env.example .env

Edit .env with your local settings. Never commit secrets.

3. Start infrastructure

docker compose up -d

4. Install dependencies

pnpm install

5. Apply database schema

pnpm db:push

6. Start development servers

cd apps/web && pnpm dev    # Web + docs on :3000
# In another terminal:
cd backend && pnpm dev     # API on :4000

Or from root: pnpm dev (requires all workspace packages).


Verification

  1. Visit http://localhost:3000/docs — Documentation Center loads
  2. Register at http://localhost:3000/register
  3. Open Mission Control at http://localhost:3000/dashboard/mission-control

Safe Defaults

EXECUTIVES_ENABLED=false
AUTONOMOUS_EXECUTION_ENABLED=false

Executives and autonomous execution require certification and governance review before enabling.


Related