Skip to content
Blue Dots Economy Documentation

Single Instance

One API instance serves one binding such as:

Terminal window
SERVED_DOMAINS="yellow_dot/student"
Section titled “Recommended Env Shape”
Terminal window
INSTANCE_NAME="Dpg Api"
INSTANCE_ENV="production"
API_DOMAIN="https://api.example.com"
API_PORT="2742"
SERVED_DOMAINS="yellow_dot/student"
NETWORK_CONFIG_SOURCE="remote"
NETWORK_CONFIG_URLS="yellow_dot=https://registry.example.com/yellow-dot/network.json"

Why This Is The Simplest Setup

Section titled “Why This Is The Simplest Setup”
  • one public API domain
  • one backend deployment
  • one network/domain identity
  • network config can derive allowed instance origins for CORS

Deployment Method

Section titled “Deployment Method”

For Dokploy or any container platform, build the API with:

Terminal window
docker build -f apps/api/Dockerfile -t dpg-api .

The container starts node apps/api/dist/server.js and listens on API_PORT.

Local Development Equivalent

Section titled “Local Development Equivalent”
Terminal window
SERVED_DOMAINS="yellow_dot/student"
NETWORK_CONFIG_SOURCE="local"
NETWORK_CONFIG_LOCAL_FILE="examples/schemas/yellow_dot/network.json"