Skip to content

Commands Reference

All commands are managed via just. Run just with no arguments to list them.

Dev Environment

Command Description
just setup Start dev databases (PG + Redis) and set up Python venv via uv
just seed Seed initial data (Tenant / Team / User / Assets / Accounts)
just python-setup Install Python via apt/brew and create virtualenv
just just-install Install just via brew (macOS) or prebuilt binary (Linux)
just docker-install Install Docker on Debian/Ubuntu

Application

Command Description
just dashboard Run FastAPI dashboard at http://localhost:8000
just nt Run NautilusTrader node (5 strategies + DatabaseActor)

Database Migrations

Command Description
just migration-generate [msg] Generate Alembic migration (default msg: "auto")
just migration-run [target] Apply migrations (default target: head)

Observability Stack

Command Description
just obs-up Start observability stack (Mimir + Alloy + Grafana + Loki)
just obs-down Stop observability stack
just obs-logs Tail all service logs (Ctrl-C to exit)
just obs-restart <service> Restart a single service (e.g. just obs-restart grafana)

Trader Container

Command Description
just trader-build Build nt_trader Docker image
just trader-up Start trader container (obs stack must be running)
just trader-down Stop trader container
just trader-rebuild Rebuild image and restart in one step
just trader-logs Tail trader container logs

Production

Command Description
just prod-up Start full production system (obs stack + trader)
just prod-down Stop full production system

Docker Swarm

Command Description
just swarm-init Initialize Swarm (safe on already-initialized node)
just swarm-build Build the dashboard image for Swarm
just swarm-deploy Deploy or update the stack
just swarm-up Build and deploy in one step
just swarm-down Remove the Swarm stack
just swarm-ps Show running services
just swarm-logs <service> Tail logs for a service (e.g. just swarm-logs dashboard)

Documentation

Command Description
just docs-serve Serve documentation locally at http://localhost:8001
just docs-build Build the static documentation site