Desplegar sus aplicaciones con Dokku en un VPS

Donde otros PaaS incorporan una interfaz web y un orquestador completo, Dokku sigue siendo deliberadamente minimalista: se trata de un conjunto de scripts de shell que pilotan Docker. Usted envía su código con git push dokku main, Dokku detecta el lenguaje mediante los buildpacks de Heroku o un Dockerfile, construye la imagen y publica la aplicación. Todo se gestiona por línea de comandos, lo que lo hace extremadamente ligero y previsible.

CapRover, Coolify y Easypanel ofrecen todos una interfaz gráfica, pero a un coste de memoria muy superior. CapRover recomienda 2 GB de RAM como mínimo; Coolify 4 también requiere 2 GB por su PostgreSQL integrado; Easypanel necesita 2 GB en cuanto hay un build activo. Dokku, en cambio, funciona desde 512 MB de RAM para una aplicación ligera y no añade ningún componente de control permanente.

Dokku es el PaaS más económico en recursos de esta serie.

RAM. 512 MB es suficiente para una aplicación ligera. Prevea 1 GB para un uso habitual y 2 GB en cuanto sus builds usen buildpacks (Node, Ruby, Python compilan en memoria) o aloje una base de datos en el mismo VPS. Para varias aplicaciones en paralelo con PostgreSQL, apunte a 4 GB.

CPU. 1 vCPU es suficiente para aplicaciones ligeras. Las fases de build de buildpack son intensivas en CPU pero no bloquean el despliegue.

Disco. Cuente con 20 GB de SSD mínimo.

Swap. En un VPS de 1 o 2 GB de RAM, añada siempre 2 GB de swap para evitar que el OOM killer del kernel mate un build de Node o Ruby.

Sistema. Ubuntu 22.04 LTS o 24.04 LTS recién instalado, sin Docker ni Nginx preinstalados. Los puertos 22 (SSH), 80 y 443 deben estar abiertos.

DNS. Configure un dominio por aplicación o un dominio wildcard *.your-domain.com apuntando a la IP del VPS.

Dokku gestiona cada aplicación en un contenedor aislado. Puede alojar tantas aplicaciones como soporte su VPS.

Variables de entorno. Use dokku config:set para inyectar secretos o parámetros de configuración:

dokku config:set my-app NODE_ENV=production \
  SECRET_KEY=changeme

Staging vs producción. La práctica habitual es crear dos aplicaciones en el mismo servidor:

dokku apps:create my-app-staging
dokku apps:create my-app-production

Dominios personalizados. Para asociar un dominio existente:

dokku domains:add my-app your-domain.com

Dokku gestiona el zero-downtime mediante checks de salud antes de la conmutación. Configure un fichero CHECKS en la raíz de su proyecto:

WAIT=10
TIMEOUT=60
/healthz Application is up

Tags y rollback. Dokku conserva las imágenes Docker de despliegues anteriores como tags. Para revertir:

dokku tags:list my-app
dokku tags:deploy my-app v3

Para crear un tag de seguridad antes de un despliegue arriesgado:

dokku tags:create my-app stable-before-migration

PostgreSQL. El más utilizado. Comandos adicionales útiles: dokku postgres:backup my-db para un volcado manual, dokku postgres:connect my-db para acceso psql interactivo.

Redis.

dokku plugin:install https://github.com/dokku/dokku-redis.git
dokku redis:create my-cache
dokku redis:link my-cache my-app

Inyecta la variable REDIS_URL en el contenedor.

Cron (planificador). Cree un fichero app.json en la raíz de su proyecto:

{
  "cron": [
    { "command": "php artisan schedule:run", "schedule": "* * * * *" }
  ]
}

error: failed to push some refs — permiso denegado.
Compruebe que su clave SSH está registrada: dokku ssh-keys:list. Si está ausente, añádala con dokku ssh-keys:add admin < ~/.ssh/id_ed25519.pub.

! [remote rejected] — hook pre-receive rechazado.
Este error indica un fallo de build en el lado de Dokku. Consulte los logs detallados con dokku logs my-app.

La aplicación devuelve 502 Bad Gateway.
Compruebe el estado del proceso: dokku ps:report my-app. Causa frecuente: la aplicación no escucha en el puerto declarado en el Procfile.

letsencrypt:enable falla — timeout del challenge HTTP-01.
El desafío ACME requiere que el dominio resuelva a la IP del VPS antes de la activación. Verifique la propagación DNS: dig +short my-app.your-domain.com.

El build es eliminado por el kernel (OOM) — Killed.
El OOM killer intervino por falta de memoria. Añada swap o migre a un VPS con 2 GB de RAM.

Dokku cubre el despliegue de aplicaciones de contenedor único en un VPS. Si su arquitectura evoluciona hacia varios servicios interdependientes, varias alternativas de la misma familia complementan este enfoque: CapRover añade una interfaz gráfica y un modo clúster Docker Swarm. Easypanel simplifica la gestión multi-servicio con Nixpacks y un marketplace de aplicaciones. Todas estas herramientas funcionan en un VPS Cloud de ServOrbit con Ubuntu LTS.