Zero-Downtime Deployments

How it works

Server Compass uses a blue-green deployment strategy:

1. A new container is started alongside the existing one
2. Health checks validate the new container is responding correctly
3. Traefik switches traffic to the new container
4. The old container is stopped and removed

Your users experience zero interruption during the entire process.

Enabling zero-downtime deploys

1. Open your app's settings
2. Enable Zero-Downtime Deployment
3. Configure the health check endpoint (default: /)
4. Set the health check interval and timeout
5. Deploy as normal — Server Compass handles the blue-green swap automatically

Health check configuration

Health checks ensure the new container is ready before switching traffic:

• Endpoint: The URL path to check (e.g., /health or /)
• Interval: How often to check (default: 5 seconds)
• Timeout: How long to wait for a response
• Retries: Number of consecutive successes required before switching

If the health check fails, the new container is removed and the old one continues serving traffic.