Registry — DigitalOcean
Cómo dar de alta un registry privado de Docker para que Dokploy haga
pullde imágenes propias en vez de construir desde el código. Complementa Providers → Docker.⚠️ Evaluado y descartado a favor de GitLab por el plan gratis limitado — ver Registry + Dockerfile (GitLab). Esta guía sigue válida si se paga el plan Basic/Professional.
1. Qué es
Un Container Registry guarda las imágenes Docker ya construidas para bajarlas (pull) desde cualquier servidor sin reconstruir. DigitalOcean ofrece uno integrado a la misma cuenta del droplet.
Diferencia con build en el servidor (Nixpacks):
| Build en el servidor | Imagen desde Registry | |
|---|---|---|
| Dónde se construye | En el droplet, cada deploy | En CI o local, una vez |
| Qué hace Dokploy | Clona y compila | Solo docker pull |
| Costo en el droplet | Alto durante el build | Mínimo |
| Rollback | Re-buildear un commit | Instantáneo (tag anterior) |
2. Cuándo conviene
- El build tarda o consume mucho del droplet (relevante con 4 GB).
- Separar build (CI) de deploy (Dokploy solo pull) — acerca el pipeline
.gitlab-ci.ymlpendiente de API Express. - La misma imagen en varios servidores sin reconstruir.
3. Configurar
En DigitalOcean
- cloud.digitalocean.com/registry/new → Create a Container Registry (nombre en minúsculas).
- Actions → Download Docker Credentials (Read + Write). Copiar el valor de
auth→ será el Password en Dokploy. - Generar un API token con permisos Registry. El access token → será el Username en Dokploy.
En Dokploy
| Campo | Valor |
|---|---|
| Registry Name | descriptivo, ej. My Registry |
| Username | el access token del paso 3 |
| Password | el valor auth del paso 2 |
| Registry URL | registry.digitalocean.com |
Dar Test antes de Create.
El par usuario/contraseña no es el login normal de DigitalOcean — es un access token de la API (como "usuario") emparejado con el
authdel archivo de credenciales (como "contraseña"). Dos artefactos separados.
4. Uso posterior
Queda disponible como Provider: Docker al configurar una app — Dokploy hace login automático y puede hacer pull de imágenes privadas sin pedir credenciales cada vez.