If yourDocumentation Index
Fetch the complete documentation index at: https://docs.slipway.sh/llms.txt
Use this file to discover all available pages before exploring further.
slipway.yaml references a private image — via services.*.image or via a base image in a private registry — slipway needs credentials to pull it. Configure them once at the org level; no per-service config is required.
Add a registry
Under Settings → Registries → Add registry:- Registry host. The hostname (e.g.
ghcr.io,index.docker.io,123456789012.dkr.ecr.us-east-1.amazonaws.com). - Username and password (or token).
- Save.
How they’re used
At deploy time, slipway assembles a Dockerconfig.json from every registry configured for the org and materializes it as a Kubernetes Secret in:
- The build namespace, so BuildKit can pull private base images during
RUN/FROMsteps. - The tenant namespace, so the kubelet can pull images referenced by
services.*.image.
registries_resolved event with the list of hosts wired up for that run.
Common registries
| Registry | Hostname | Username | Password |
|---|---|---|---|
| Docker Hub | index.docker.io | your Docker Hub username | a Docker Hub access token |
| GitHub Container Registry | ghcr.io | your GitHub username | a personal access token with read:packages |
| Amazon ECR | <acct>.dkr.ecr.<region>.amazonaws.com | AWS | the output of aws ecr get-login-password (note: rotates every 12 hours, see below) |
| Google Artifact Registry | <region>-docker.pkg.dev | _json_key | the full JSON of a service-account key |
| Azure Container Registry | <name>.azurecr.io | your service principal ID or admin user | the corresponding password |
A note on ECR
Amazon ECR auth tokens expire every 12 hours. Storing the output ofget-login-password directly means re-rotating it twice a day, which is impractical. If you’re using ECR heavily, prefer images on a registry that supports long-lived credentials (GHCR, Docker Hub) or contact us about IAM-role-based auth.
Permissions
| Role | View hosts | View passwords | Create / update / delete |
|---|---|---|---|
| Viewer | yes | no | no |
| Developer | yes | no | no |
| Admin | yes | no | yes |
| Owner | yes | no | yes |