Deployment¶

Atlas provides two Docker Compose topologies that use the same images and environment file: a source-mounted development topology for daily work and an immutable, same-origin production-like topology for deployment-like environments.

Both read core/backend/.env (copied from core/backend/.env.example) and are started with docker compose --env-file core/backend/.env .... See Environment Variables for what belongs in that file.

• Development topology: source-mounted with automatic reloading for local iteration
• Production-like topology: immutable images, one gateway port, and no mounted source
• Operations: migrations, logs, shutdown, and local-data resets
• Troubleshooting: startup verification and common failures