Private Docker registry
You’ll register credentials so instances can pull private images.
Before you start
- A registry that hosts your images (Harbor, GHCR, Docker Hub private, self-hosted, …)
- A robot / deploy user with pull permission (prefer least privilege)
Add registry credentials
- Create a deploy token or password in your registry.
- In Xooshe, open Registries (home dashboard action) or the registry settings for your cluster.
- Add the registry host and credentials.
- Deploy or restart an app that uses a private image.
You’re done when
- App status becomes healthy (no ImagePull errors).
- Logs start streaming from the new instances.
If it fails
| Symptom | Fix |
|---|---|
| Still failing to pull | Confirm the image path includes the registry host and that the token can pull that repository |
| Works for one environment but not another | Re-check Registries for the selected cluster — credentials are scoped per cluster |