[Feature Request] Add Registry Provider for Application Deployments
Nobody has claimed this yet.
- Dominant language
- TypeScript
- Stars
- 37.4k
- Forks
- 3k
- Avg merge
- 1d 3h
- Merged PRs (30d)
- 73
Description
What problem will this feature address?
Currently, Dokploy supports deploying applications from various sources (GitHub, GitLab, Docker Hub, etc.), but there's no convenient way to deploy directly from private Docker registries configured in the system. Users had to manually type the full image path, credentials, and registry URL in the Docker provider form — a cumbersome and error-prone process.
Describe the solution
Enhanced the existing Docker provider tab with a registry browser:
- Registry selector — Choose from registries already configured in the system
- Image browser — Searchable combobox that fetches the image catalog from the selected registry via
/v2/_catalog - Tag browser — Searchable combobox that fetches available tags via
/v2/{image}/tags/list - Auto-fill — Selecting a tag automatically populates the Docker image path, username, password, and registry URL fields
- Manual fallback — The original manual input fields remain available when no registry is selected
Why this approach
- No new source type or deployment pipeline needed — reuses the existing Docker deployment workflow
- Credentials and image path are still stored the same way, so existing deployments are unaffected
- Less complexity, same end result: users can deploy from private registries with just a few clicks
Describe alternatives you've considered
- Manual Docker deployment: Requires SSH access and breaks the Dokploy workflow.
- Using Docker Hub: Doesn't work for private/enterprise registries.
- Custom scripts: Bypasses Dokploy's management features.
- Docker Compose: Requires additional configuration and doesn't integrate with Dokploy's UI.
Additional context
Implemented in #3903.
Will you send a PR to implement it?
Yes — see #3903
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
Review pull request #3903 first, since the issue says the feature is already implemented there. Start at the existing Docker provider tab and the registry endpoints /v2/_catalog and /v2/{image}/tags/list; verify registry selection, image and tag browsing, credential and image-path auto-fill, and the manual fallback match the requested behavior.
Written by the indexing model from the issue text.
Assessment
- Tech stack
- docker, typescript
- Domain
- backend-api-design, devops, frontend
- Issue type
- Feature
- Difficulty
- 4/5
- Estimated time
- 3-5 days
- Activity status
- Stale
- Clarity
- Mostly clear
- Newbie friendliness
- 15/100