Environments and Configuration

Deployment Environments

Environment	Frontend URL	API URL	Database
Development	`http://localhost:8080`	`http://localhost:3000`	Local PostgreSQL (:5432)
Staging	`https://staging.app.equa.cc`	Same-origin `/api/v1` via the staging SPA host; any direct staging API hostname must be verified separately	Staging PostgreSQL
Production	`https://app.equa.cc` (current interim host)	Same-origin `/api/v1` via the SPA host and nginx proxy; direct `api.equa.cc` usage is a separate host-level concern	Production PostgreSQL

Local Development Port Map

Source: equa-start-dev skill, verified against package.json scripts and service configs.

Port	Service	Repository	Command
3000	equa-server (Express backend API)	`equa-server`	`yarn start:dev`
3001	command-center-so (Next.js dev)	`command-center-so`	`npm run dev` (runs `next dev -p 3001`; open `/command-center`)
3333	equa-patternlib (Next.js dev, optional)	`equa-patternlib-nextjs`	`npm run dev` (runs `next dev -p 3333`)
3337	equa-docs (Mintlify dev preview)	`equa-docs`	`npm run dev` (runs `mintlify dev --port 3337`)
5432	PostgreSQL (Docker)	`equa-server`	`docker-compose up -d`
6006	Storybook (component library)	`equa-patternlib-nextjs`	`npm run storybook`
8080	equa-web (Webpack dev server)	`equa-web`	`yarn start`
9222	Comet-Bridge CDP (Comet browser)	`Comet-Bridge`	`comet session start`
18789	equabot Gateway (WebSocket)	`equabot`	`node scripts/run-node.mjs --dev gateway --port 18789`
18791	equabot Browser Control	`equabot`	(started with gateway)
19792	Equanaut API (Hetzner/local)	External	FastAPI server

Port 3000 is reserved for equa-server. The command-center-so npm run dev script binds to port 3001 (next dev -p 3001). The equa-patternlib npm run dev script binds to port 3333 (next dev -p 3333). Equa Docs binds to port 3337 to avoid that patternlib conflict. Never run other services on port 3000.

Backend Environment Variables

Source: equa-server/modules/api/src/server.ts, equa-server/modules/persistence/src/site/connecting.ts, equa-server/modules/auth/src/

Database

Variable	Default	Description
`DATABASE_TYPE`	`postgres`	Database type
`DATABASE_HOST`	—	Database hostname
`DATABASE_USERNAME`	—	Database user
`DATABASE_PASSWORD`	—	Database password
`DATABASE_NAME`	—	Database name
`DATABASE_SCHEMA`	—	Database schema
`DATABASE_LOGS`	—	Comma-separated logging options
`DATABASE_MAX_QUERY_TIME`	—	Slow query threshold
`DATABASE_SYNC`	—	Set to `false` to disable schema sync in dev

Server

Variable	Default	Description
`PORT`	`3000`	Express server port
`NODE_ENV`	—	`development` or `production`
`API_SSL`	—	Enable HTTPS
`SSL_PRIVATE_KEY_PATH`	—	Path to SSL private key
`SSL_PUBLIC_KEY_PATH`	—	Path to SSL certificate
`LOG_ERRORS`	`true`	Enable error logging
`APP_URL`	`https://localhost:8080`	Frontend URL (for email links)

Authentication

Variable	Default	Description
`API_SESSION_SECRET`	—	Express session secret
`API_SESSION_MAX_AGE`	`2520000`	Session max age in ms (~42 minutes)
`GOOGLE_OAUTH_CLIENT_ID`	—	Google OAuth client ID
`TWO_FACTOR_PRIVATE_KEY`	—	2FA encryption key
`MAGIC_LINK_EXPIRY_MINUTES`	`15`	Magic link token expiry
`EMAIL_VERIFICATION_LIMIT_SECONDS`	`1800`	Email verification rate limit
`REGISTRATION_IP_LIMIT`	`20`	Max registrations per IP

Email / Notifications

Variable	Default	Description
`EMAIL_TRANSPORTER`	—	`dev`, `smtp`, or default (AWS SES)
`SMTP_HOST`	—	SMTP server hostname
`SMTP_PORT`	—	SMTP port
`SMTP_SECURE`	—	Use TLS
`SMTP_USER`	—	SMTP username
`SMTP_PASS`	—	SMTP password
`AWS_SES_REGION`	`us-east-1`	SES region
`FROM_EMAIL_NAME`	—	Sender display name
`FROM_EMAIL_ADDRESS`	—	Sender email address
`GLOBAL_BCC`	—	BCC address for all emails

File Storage

Variable	Default	Description
`AWS_S3_UPLOAD_SIZE_LIMIT_MB`	`10`	Max upload size in MB
`STATIC_FILE_URL`	—	Static file serving URL

Integrations

Variable	Default	Description
`MS_AUTH_CLIENT_ID`	—	Microsoft OAuth client ID
`MS_AUTH_TENANT_ID`	—	Microsoft tenant ID
`MS_AUTH_SECRET`	—	Microsoft OAuth secret
`MS_AUTH_ENABLED`	—	Enable Microsoft integration
`GOOGLE_DRIVE_CLIENT_ID`	—	Google Drive OAuth client ID
`GOOGLE_DRIVE_CLIENT_SECRET`	—	Google Drive OAuth secret
`GOOGLE_DRIVE_REDIRECT_URI`	—	Google Drive OAuth redirect
`GOOGLE_DRIVE_ENABLED`	—	Enable Google Drive integration
`ANTHROPIC_API_KEY`	—	Claude API key for Equanaut

Frontend Environment Variables

Source: equa-web/webpack.config.js (DefinePlugin)

Variable	Default	Description
`API_URL`	`/api/v1`	Backend API base URL
`CAPTCHA_SITE_KEY`	—	Required. reCAPTCHA v2 site key. Without it, auth forms will not render the CAPTCHA widget (hardcoded test key removed in PR #493). Get from Google reCAPTCHA console.
`EQUANAUT_API_URL`	`/equanaut-api`	Equanaut AI API URL
`EQUANAUT_MODEL`	`claude-sonnet-4-20250514`	Default AI model
`API_PROXY_URL`	`http://localhost:3000`	Dev proxy target for `/api`
`EQUANAUT_PROXY_URL`	`http://localhost:19792`	Dev proxy target for `/equanaut-api`

The production browser build does not hardcode a Cloud Run hostname. API_URL defaults to /api/v1, and the committed nginx config proxies /api/ to the Railway-hosted backend target.

Comet-Bridge Environment Variables

Source: Comet-Bridge/comet-mcp/src/index.ts, Comet-Bridge/scripts/lifecycle-sync.mjs

Variable	Default	Description
`COMET_CC_LIFECYCLE_URL`	`http://localhost:3001/command-center/api/comet/lifecycle`	Lifecycle sync endpoint URL (overrides default for non-standard CC-SO deployments)

See Comet Browser — Environment overrides for the full Comet-Bridge variable list.

Platform Architecture

Compliance & Security

Feature Specifications

Releases

Developer Onboarding

Business

Reference & Templates

Environments and Configuration

Environments and Configuration

Deployment Environments

Local Development Port Map

Backend Environment Variables

Database

Server

Authentication

Email / Notifications

File Storage

Integrations

Frontend Environment Variables

Comet-Bridge Environment Variables

​Environments and Configuration

​Deployment Environments

​Local Development Port Map

​Backend Environment Variables

​Database

​Server

​Authentication

​Email / Notifications

​File Storage

​Integrations

​Frontend Environment Variables

​Comet-Bridge Environment Variables

Environments and Configuration

Deployment Environments

Local Development Port Map

Backend Environment Variables

Database

Server

Authentication

Email / Notifications

File Storage

Integrations

Frontend Environment Variables

Comet-Bridge Environment Variables