Dokploy puede desplegar repositorios Git o proyectos de Docker Compose en tu propio servidor. Sigues siendo dueño del VPS, las bases de datos y los contenedores; simplemente delegas las tareas repetitivas de despliegue al panel.

Encaja en estos escenarios:

• Quieres autoalojar en un VPS una alternativa a Vercel, Heroku o Railway;
• Necesitas despliegue continuo desde GitHub, GitLab, Gitea o Bitbucket;
• Ejecutas varios sitios web, API, workers y bases de datos en un mismo servidor;
• Quieres ver de forma unificada los registros de compilación, el estado de los contenedores, los dominios y los certificados;
• No quieres mantener Kubernetes desde el principio.

Si solo ejecutas un contenedor que no cambia durante mucho tiempo, una configuración de Docker Compose para producción suele ser más sencilla. El valor de Dokploy está en múltiples proyectos, publicaciones frecuentes y colaboración en equipo.

La recomendación oficial actual de Dokploy es de al menos 2 GB de memoria y 30 GB de disco. Esto es solo el punto de partida para instalar y compilar sin problemas, no significa que todas las aplicaciones quepan en 2 GB.

Al compilar imágenes de Next.js, Java o Rust, el uso momentáneo de memoria y disco aumenta de forma notable. Si el presupuesto es limitado, es mejor empezar con 4 GB que dejar que los procesos de compilación y las bases de datos se disputen los últimos cientos de MB de memoria. Para un método de selección más detallado, consulta Cómo elegir la configuración del VPS.

Los sistemas de prueba que figuran en la documentación oficial incluyen Ubuntu 20.04/22.04/24.04 LTS, Debian 10/11/12, Fedora 40 y CentOS 8/9. Para despliegues nuevos, conviene elegir una versión Ubuntu LTS o Debian 12 que siga dentro de su periodo de mantenimiento.

Prepara un VPS público limpio y confirma:

1. Puedes iniciar sesión por SSH y obtener privilegios de root;
2. El registro A del dominio apunta a la IPv4 pública del VPS;
3. Los puertos TCP 80, 443 y 3000 no están ocupados por Nginx, Caddy, Apache u otro panel;
4. El grupo de seguridad del proveedor cloud y el firewall del sistema permiten el acceso a estos puertos durante la instalación;
5. El disco tiene al menos 30 GB de espacio libre.

Revisa primero los puertos:

sudo ss -lntp | grep -E ':(80|443|3000)\b' || true

Si hay salida, primero determina si el servicio existente se puede migrar. Dokploy usa Traefik para ocupar los puertos 80 y 443, por lo que instalarlo directamente en una máquina que ya ejecuta un sitio web suele provocar conflictos de puertos. Para migraciones en producción, prepara primero una máquina nueva o una ventana de mantenimiento.

Ejecuta el script de instalación oficial en un shell de root:

curl -sSL https://dokploy.com/install.sh | sh

Si el servidor aún no tiene Docker, el script de instalación lo instala automáticamente. Cuando termine, accede desde el navegador a:

http://你的服务器IP:3000

Crea de inmediato la cuenta de administrador. No expongas el puerto 3000 a todas las fuentes de forma prolongada; primero completa el dominio del panel y HTTPS, y después cierra la entrada por IP pública y puerto.

Si la instalación falla, revisa primero:

docker version
docker info
docker service ls
docker ps
sudo ss -lntp | grep -E ':(80|443|3000)\b'

Dokploy usa Docker Swarm. Si el servidor cloud tiene varias tarjetas de red o la detección automática es incorrecta, puedes especificar explícitamente la dirección de anuncio:

curl -sSL https://dokploy.com/install.sh | sudo ADVERTISE_ADDR=你的服务器IP sh

Primero prepara un subdominio dedicado para el panel, por ejemplo deploy.example.com, y apunta su registro A al VPS. Entra en la configuración de Domains de Dokploy, añade el dominio y activa el certificado.

Después de confirmar que puedes iniciar sesión con normalidad en https://deploy.example.com, elimina la asignación pública de IP:3000 como recomienda la documentación oficial:

docker service update \
  --publish-rm "published=3000,target=3000,mode=host" \
  dokploy

El orden importa. Si eliminas el puerto 3000 antes de que el dominio o el certificado estén activos, puedes quedarte fuera del panel.

Al final, el firewall solo necesita abrir al público los puertos necesarios:

sudo ufw allow OpenSSH
sudo ufw allow 80/tcp
sudo ufw allow 443/tcp
sudo ufw enable

Para una estrategia más completa de SSH, Fail2Ban y firewall, consulta la guía de endurecimiento de seguridad para VPS.

Crea un Project en Dokploy y luego añade una Application. El flujo habitual es:

1. Conectar GitHub, GitLab, Gitea o Bitbucket;
2. Seleccionar el repositorio y la rama de producción;
3. Elegir el método de compilación, por ejemplo Dockerfile, Nixpacks o sitio estático;
4. Indicar el puerto del contenedor en el que escucha la aplicación;
5. Añadir las variables de entorno;
6. Pulsar Deploy y observar los registros de compilación y ejecución;
7. Añadir el dominio de la aplicación y activar HTTPS.

La aplicación debe escuchar en 0.0.0.0 dentro del contenedor, no solo en 127.0.0.1. Por ejemplo, una aplicación Node debe escuchar en el PORT que proporciona la plataforma; de lo contrario, el contenedor puede aparecer en ejecución pero Traefik no podrá acceder a él.

No subas .env, contraseñas de bases de datos ni claves de API a Git. Coloca las variables de producción en la configuración de variables de entorno de Dokploy y distingue entre variables de tiempo de compilación y de tiempo de ejecución. Tras modificar variables, vuelve a desplegar y confirma que el nuevo contenedor cargó realmente los nuevos valores.

Los dominios de Application en Dokploy se configuran dinámicamente mediante Traefik; los proyectos de Docker Compose normalmente necesitan volver a desplegarse tras cambiar un dominio para que Traefik vuelva a leer las etiquetas.

Orden de diagnóstico:

dig +short app.example.com
curl -I http://app.example.com
docker service ls
docker service ps 服务名
docker service logs 服务名 --tail 100

Céntrate en confirmar cuatro cosas:

• Si el DNS apunta realmente al VPS actual;
• Si los puertos 80/443 están bloqueados por el grupo de seguridad o UFW;
• Si el puerto del contenedor está configurado con el puerto real en el que escucha la aplicación;
• Si el proceso de la aplicación escucha en 0.0.0.0.

Si necesitas entender los certificados automáticos y la cadena del proxy inverso, continúa con la guía de HTTPS automático con Caddy. La implementación es distinta, pero el enfoque de diagnóstico de DNS, puertos y escucha del upstream es el mismo.

Que en el panel aparezca "el contenedor está en ejecución" no significa que los datos estén seguros. Debes proteger por separado al menos tres tipos de datos:

1. El PostgreSQL propio de Dokploy y /etc/dokploy;
2. Las bases de datos de negocio;
3. Los archivos subidos o datos SQLite en volúmenes con nombre de Docker.

Las copias de seguridad del sistema de Dokploy requieren configurar primero un destino compatible con S3. Las copias del sistema empaquetan el PostgreSQL de Dokploy y /etc/dokploy, y luego los suben al almacenamiento de objetos. Las bases de datos de negocio deben tener copias programadas aparte; las aplicaciones que usan volúmenes con nombre también deben activar Volume Backups.

No pongas el destino de las copias en el mismo disco que el VPS, o las copias se perderán junto con el servidor si este falla. Haz un simulacro de restauración al menos una vez por trimestre para verificar credenciales, archivos y pasos de restauración. Puedes aplicar directamente la lista de verificación de simulacros de copia y restauración en VPS.

El comando oficial para actualizar a la última versión es:

curl -sSL https://dokploy.com/install.sh | sh -s update

En producción, no ejecutes una actualización en cuanto la veas. Primero completa las copias de seguridad del sistema y de las bases de datos, lee las notas de la versión y elige una ventana de bajo tráfico para actualizar. Las publicaciones de aplicaciones deben tener configurados health checks; solo con ellos Docker Swarm tiene una base fiable para detener una versión defectuosa o ejecutar una reversión.

Además, asegúrate de:

• Usar solo inicio de sesión SSH con clave, desactivando el inicio de sesión remoto con contraseña y con contraseña de root;
• Activar HTTPS en el dominio del panel y no exponer el puerto 3000 de forma prolongada;
• Limitar los permisos de los miembros del equipo y no compartir la cuenta de administrador;
• No asignar bases de datos directamente a la red pública;
• Limpiar periódicamente imágenes y cachés de compilación sin usar, pero sin borrar por error datos que aún usan los volúmenes;
• Configurar alertas para fallos de disco, memoria, certificados y copias de seguridad.

Portainer es más un gestor de contenedores, mientras que Dokploy y Coolify son más plataformas de despliegue. Si quieres gestionar directamente Stacks, contenedores, redes y registros, lee el tutorial del panel de gestión Docker Portainer.

Lo más atractivo de Dokploy no es la "instalación con un clic", sino reunir Git, compilaciones, contenedores, dominios, certificados, bases de datos y copias de seguridad en un proceso de publicación repetible. El enfoque realmente apto para producción es: empezar con un VPS limpio de al menos 2 GB/30 GB, resolver primero los puertos y el DNS, desplegar después las aplicaciones y, por último, completar las copias de seguridad externas, los health checks y el control de acceso.

Si vas a ejecutar varios proyectos a largo plazo, elige directamente 4 GB de memoria y disco NVMe, y realiza un simulacro de restauración de Dokploy desde una copia en S3 antes de poner en marcha tu primer negocio.

• Documentación de instalación de Dokploy
• Configuración de dominios de Dokploy
• Copias de seguridad del sistema de Dokploy
• Dokploy Volume Backups