Registry Credentials Not Applied to Remote VPS
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 37.4k
- Forks
- 3k
- Avg merge
- 1d 3h
- Merged PRs (30d)
- 73
Description
To Reproduce
- Configure running on a server of your choosing
- Configure Dokploy with remote VPS target
- Add private registry credentials in Dokploy UI
- Create docker-compose project referencing private image
- Deploy to remote VPS
- Observe authentication failure
Current vs. Expected behavior
Current Behavior
-
Registry credentials added in Dokploy UI:
- Registry:
ghcr.io - Username:
my_gh_username - Credentials: GitHub Token following the docs
- Registry:
-
Docker Compose deployment with private image fails:
mdm-api Error Head "https://ghcr.io/v2/my_gh_username/myrepo/my_image/manifests/latest": unauthorized -
Checking
~/.docker/config.jsonon VPS shows noghcr.ioentry or more rightly said no file at all
Expected Behavior
Registry credentials should either:
- Be automatically synced to remote VPS Docker config, OR
- Be injected via docker-compose auth mechanisms, OR
- Documentation should clarify manual login is required for remote deployments
Provide environment information
### Environment
- **Dokploy Setup:** Control panel on one local machine running on ubuntu:24, deployments on remote VPS running ubuntu 24
- **Deployment Type:** Docker Compose
- **Registry:** GitHub Container Registry (ghcr.io)
- **Dokploy Version:** v0.25.3
Which area(s) are affected? (Select all that apply)
Docker Compose
Are you deploying the applications where Dokploy is installed or on a remote server?
Remote server
Additional context
Workaround
Manual SSH to VPS and login:
docker login ghcr.io -u ...
Will you send a PR to fix it?
No
Contributor guide
First steps
- Read the whole issue, then the project's contributing guide.
- Comment on the issue to say you are picking it up — it saves two people doing the same work.
- Fork the repository and make your change on a branch.
- Open a pull request that references the issue number.
Research direction
No specific file or test is named in the report. Start at the Docker Compose deployment path for remote VPS targets and trace how UI registry credentials are passed to the remote Docker daemon. Done means a private ghcr.io image deploys without manual login, or the required manual login is clearly documented.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker, docker-compose
- Domain
- devops, infrastructure
- Issue type
- Bug
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Active
- Clarity
- Mostly clear
- Newbie friendliness
- 52/100