Plan Your Solution
Dev, Test, and Production Environments
Overview
Planning an Arch deployment means making two kinds of decisions: how the system is physically arranged, and what environment it is running in. The deployment model determines the topology — how many machines, how services are distributed, how they scale. The environment determines the configuration — local development tooling, live test infrastructure, or production credentials and certificates. The pages in this section cover both dimensions so you can make informed choices before you start building.
Deployments
Before choosing an environment, decide on a deployment model. Each Arch microservice is independently scalable, so the same application can run all on one machine, across a distributed infrastructure, or as an autoscaling cluster — without changing any application code. Choosing the right model early shapes your infrastructure plan for every environment that follows.
Dev
The development environment runs entirely on your local machine through .NET Aspire. Aspire orchestrates Sql Server, the Control Panel, and all Arch microservices as Docker containers. Your application code runs as a .NET project within the same Aspire AppHost. The entire system starts with a single F5 — no Docker Compose files, no external services required.
Test
The test environment is a real Docker deployment. It runs real Sql Server databases, real Arch microservice images, and live third-party integrations such as Postmark for email. This is the first environment where the full system operates as it would in the field. Every microservice is configured through the Control Panel and deployed via Docker Compose.
Production
The production environment is structurally identical to test. The difference is configuration: production credentials, certificates for HTTPS, diagnostics disabled, and production-grade third-party accounts. Because the shape of the system is the same, a deployment that passes in test translates directly to production.
Tech Sovereignty
Arch
Company
About Contact