Quick Start

git clone git@github.com:wenex-org/client-backend.git

cd client-backend
cp .env.example .env

# Clone git submodules
pnpm run git:clone
pnpm run git checkout main

# Install node dependencies
pnpm install --frozen-lockfile

Next Step:

• Add Remote (Optional)
• Start Essential Utilities
• DB Seeding and Initialization
• Start Up and Running using Docker
• Manually Start Up and Running Client

Add Remote (Optional)

pnpm run git:remote:add staging example.com

Note: stage must be staging or production.

Start Essential Utilities

docker-compose -f docker/docker-compose.yml up -d
# Also required: docker/docker-compose.mg.yml (MongoDB — see docker/README.md) and
# docker/docker-compose.rds.yml (Redis). Only otlp/snq/sntr are optional. (Corrected 2026-09-20 —
# this line called them all optional while .env.example needs Mongo and Redis.)

DB Seeding and Initialization

• Using Docker
• Manual Seeding
• Coworkers Seeding

Using Docker

Note: run docker build -t wenex/client-backend:latest . before using docker solution.

docker-compose --profile platform-seed up
docker-compose --profile platform-raise up
# docker-compose --profile platform-clean up

Manual Seeding

pnpm run platform:seed
pnpm run platform:raise
# pnpm run platform:clean

Coworkers Seeding

Manual:

pnpm run coworkers:seed
pnpm run coworkers:raise
# pnpm run coworkers:clean

Using Docker:

docker-compose --profile coworkers-seed up
docker-compose --profile coworkers-raise up
# docker-compose --profile coworkers-clean up

Start Up and Running using Docker

Note: run docker build -t wenex/client-backend:latest . before using docker solution.

Start all services at once

docker-compose --profile client up -d

Manually Start Up and Running Client

Start each service you want using the following command

# Gateway
pnpm run start:dev gateway
#pnpm run start:debug[2] gateway

# Services
pnpm run start:dev services
#pnpm run start:debug[2] services

# Workers
pnpm run start:dev workers
#pnpm run start:debug[2] workers

Serve static files located at the assets directory

pnpm run serve:static