Deploying from Docker Registry

Supported registries

Server Compass supports pulling images from six registry types:

• Docker Hub — Public and private images with access tokens
• GitHub Container Registry (GHCR) — Link your GitHub account for seamless OAuth access
• GitLab Container Registry — Access tokens or deploy tokens
• Amazon ECR — Login tokens (12-hour expiry)
• Google Container Registry (GCR) — JSON key file authentication
• Custom registries — Any OCI-compliant registry

Deploy a public image

1. Open the Stack Wizard and select Pull from Registry
2. Enter the image reference (e.g., nginx:latest or ghcr.io/owner/app:v1.2)
3. Server Compass auto-detects exposed ports for 30+ popular images (Nginx, PostgreSQL, Redis, Grafana, etc.)
4. Review detected ports and resolve any conflicts with running containers
5. Configure environment variables and restart policy
6. Click Deploy — a compose file is generated and the image is pulled directly

Deploy from a private registry

1. Add registry credentials in the Registry Selector panel
2. Each registry type includes setup instructions (e.g., required scopes for GHCR tokens)
3. Test the connection before saving
4. Select the credential when deploying — Server Compass authenticates via docker login automatically
5. For GHCR, you can also link your GitHub account for OAuth-based access without manual tokens

One-click redeploy

Registry-deployed apps support instant redeployment:

1. Open the app's Deployments tab
2. Click Redeploy — Server Compass pulls the latest image digest and restarts the container
3. No rebuild needed — the updated image is pulled and swapped in place
4. Image tags are shown in your deployment history for easy tracking