Guía de Configuración de Dokploy en VPS: Plataforma de Despliegue Autohospedada

Dokploy es un PaaS de código abierto que hace que desplegar aplicaciones sea increíblemente sencillo. Piensa en él como tu Vercel/Railway personal que funciona en cualquier VPS.

¿Qué es Dokploy?

Dokploy se encarga de las partes aburridas del despliegue:

• Despliegues basados en Git — Push para desplegar
• SSL automático — Integración con Let’s Encrypt
• Docker nativo — Ejecuta cualquier aplicación en contenedores
• Plantillas de bases de datos — PostgreSQL, MySQL, Redis con un clic
• Enrutamiento con Traefik — Gestión automática de dominios
• Registros en tiempo real — Monitoriza despliegues en vivo

Dokploy vs Otras Plataformas

Característica	Dokploy	Coolify	Vercel
Precio	Gratis (coste del VPS)	Gratis (coste del VPS)	$20+/mes
Autohospedado	✅	✅	❌
Docker Compose	✅	✅	❌
Multi-servidor	✅	✅	❌
Simplicidad de UI	⭐⭐⭐⭐⭐	⭐⭐⭐⭐	⭐⭐⭐⭐⭐
Funcionalidades	En crecimiento	Maduro	Más completo

Dokploy es más nuevo, pero tiene una UI más limpia y una configuración más rápida.

Requisitos del VPS

Mínimo:

• 1 vCPU, 2GB RAM
• 25GB de almacenamiento
• Ubuntu 22.04+

Recomendado:

• 2 vCPU, 4GB RAM
• 50GB de almacenamiento
• Ubuntu 22.04 o Debian 12

Mejor VPS para Dokploy

Proveedor	Plan	Especificaciones	Precio
Hostinger	KVM1	1 vCPU, 4GB RAM	$4.99/mes
Hetzner	CX21	2 vCPU, 4GB RAM	€5.39/mes
Vultr	VC2	1 vCPU, 2GB RAM	$12/mes

Instalación

Paso 1: Crear el VPS

1. Regístrate en Hetzner o Hostinger
2. Crea un servidor Ubuntu 22.04
3. Añade una clave SSH
4. Anota la dirección IP

Paso 2: Configuración DNS

Apunta tu dominio antes de la instalación:

A    dokploy.tudominio.com      → tu-ip-del-servidor
A    *.dokploy.tudominio.com    → tu-ip-del-servidor

El comodín permite que cada aplicación obtenga un subdominio.

Paso 3: Conectar al Servidor

ssh root@tu-ip-del-servidor

# Actualizar el sistema
apt update && apt upgrade -y

Paso 4: Instalar Dokploy

Un solo comando lo hace todo:

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

Esto instala:

• Docker
• La aplicación Dokploy
• Traefik como proxy inverso
• PostgreSQL (para los datos de Dokploy)

Tarda aproximadamente entre 3 y 5 minutos.

Paso 5: Acceder al Panel de Control

http://tu-ip-del-servidor:3000

Crea tu cuenta de administrador. Usa una contraseña segura.

Paso 6: Configurar Dominio y SSL

1. Ve a Configuración
2. Establece el Dominio del Servidor: dokploy.tudominio.com
3. Activa SSL/TLS
4. Introduce el correo electrónico para Let’s Encrypt
5. Guarda

Ahora accede mediante https://dokploy.tudominio.com

Despliegue de Aplicaciones

Desplegar desde GitHub

1. Proyectos → Nuevo Proyecto
2. Añade una Aplicación
3. Selecciona el origen: GitHub
4. Autoriza el acceso a GitHub
5. Elige el repositorio
6. Haz clic en Desplegar

Dokploy detecta automáticamente:

• Node.js (package.json)
• Python (requirements.txt)
• Go (go.mod)
• Dockerfile

Desplegar con Docker Compose

Para proyectos compose existentes:

1. Crea una Aplicación → Docker Compose
2. Pega tu archivo compose o selecciónalo desde el repositorio
3. Despliega

Ejemplo de compose:

version: '3.8'
services:
  web:
    image: nginx:alpine
    ports:
      - "80:80"

Desplegar con Dockerfile

1. Crea una Aplicación → Dockerfile
2. Apunta al repositorio con el Dockerfile
3. Dokploy lo construye y despliega

Configuración de Bases de Datos

PostgreSQL

1. Proyectos → Selecciona el proyecto
2. Añade Servicio → PostgreSQL
3. Establece el nombre de la base de datos y la contraseña
4. Despliega

La cadena de conexión aparece en el panel:

postgresql://postgres:password@postgres-xxx:5432/dbname

MySQL

El mismo proceso:

1. Añade Servicio → MySQL
2. Configura las credenciales
3. Despliega

Redis

1. Añade Servicio → Redis
2. Despliega
3. Usa redis://redis-xxx:6379

Dominios Personalizados

Añadir Dominio a una Aplicación

1. Selecciona la aplicación
2. Pestaña Dominios
3. Añade: app.tudominio.com
4. El SSL se provisiona automáticamente

Redirigir www a no-www

Añade ambos dominios y Dokploy gestiona las redirecciones:

tudominio.com
www.tudominio.com

Variables de Entorno

Variables de Aplicación

1. Selecciona la app → Entorno
2. Añade las variables:

DATABASE_URL=postgresql://...
SECRET_KEY=tu-secreto
NODE_ENV=production

Secretos (Cifrados)

Para datos sensibles:

1. Configuración → Secretos
2. Crea un secreto
3. Referéncialo en las apps: {{NOMBRE_SECRETO}}

Despliegues y Reversiones

Despliegues Automáticos

Activa los webhooks:

1. Configuración de la app → Build
2. Activa Despliegue Automático
3. Un push a main dispara la reconstrucción

Despliegue Manual

Haz clic en el botón Desplegar en cualquier momento.

Revertir

1. Pestaña Despliegues
2. Encuentra el despliegue anterior
3. Haz clic en Revertir

Monitorización

Registros en Tiempo Real

1. Selecciona la aplicación
2. Pestaña Registros
3. Visualiza los registros en tiempo real

Uso de Recursos

El panel muestra:

• Uso de CPU por app
• Consumo de memoria
• Uso del disco
• Tráfico de red

Comprobaciones de Salud

Configura en la configuración de la app:

Health Check Path: /health
Interval: 30s
Timeout: 5s

Copias de Seguridad

Copias de Seguridad de Bases de Datos

1. Selecciona la base de datos
2. Copias de Seguridad → Activar
3. Establece el horario
4. Configura el destino (S3, local)

Copia de Seguridad Manual

# En el VPS
docker exec dokploy-postgres pg_dump -U postgres > backup.sql

Copias de Seguridad de Volúmenes

Para aplicaciones con datos persistentes:

docker run --rm \
  -v app_data:/data \
  -v /backup:/backup \
  alpine tar czf /backup/data.tar.gz /data

Configuración Multi-Servidor

Dokploy admite múltiples servidores:

1. Servidores → Añadir Servidor
2. Instala el agente de Dokploy en el nuevo VPS:

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

3. Añade el token del servidor a Dokploy
4. Despliega aplicaciones en servidores específicos

Casos de uso:

• Separar entornos de staging y producción
• Distribución geográfica
• Aislamiento de recursos

Despliegues Habituales

Next.js

1. Crea una app → GitHub → Selecciona el repositorio
2. Comando de construcción: npm run build
3. Comando de inicio: npm start
4. Puerto: 3000

FastAPI

Dockerfile:

FROM python:3.11-slim
WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt
COPY . .
CMD ["uvicorn", "main:app", "--host", "0.0.0.0", "--port", "8000"]

Sitios Estáticos

1. Crea una app → GitHub
2. Construcción: npm run build
3. Directorio de publicación: dist o build
4. Dokploy sirve los archivos estáticos

WordPress

1. Añade Servicio → WordPress
2. La configuración con un clic incluye MySQL
3. Configura el dominio
4. Listo

Solución de Problemas

El Despliegue Falla

Revisa los registros:

1. App → Despliegues → Despliegue fallido
2. Visualiza los registros de construcción
3. Problemas habituales:
   • Dependencias faltantes
   • Puerto incorrecto
   • Comando de construcción erróneo

SSL No Funciona

1. Verifica que el DNS apunta al servidor
2. Espera a que se propague
3. Comprueba que los puertos 80/443 estén abiertos
4. Reinicia Traefik:

   docker restart dokploy-traefik

Sin Memoria Suficiente

1. Comprueba con docker stats
2. Añade swap:

   fallocate -l 2G /swapfile
   chmod 600 /swapfile
   mkswap /swapfile
   swapon /swapfile

3. Reduce las aplicaciones en ejecución simultánea

El Contenedor No Arranca

# Comprobar los registros del contenedor
docker logs container-name

# Soluciones habituales:
# - Puerto expuesto incorrecto
# - Variables de entorno faltantes
# - Fallo en el healthcheck

Optimización del Rendimiento

Activar Swap

fallocate -l 2G /swapfile
chmod 600 /swapfile
mkswap /swapfile
swapon /swapfile
echo '/swapfile swap swap defaults 0 0' >> /etc/fstab

Limpieza de Docker

# Eliminar imágenes no utilizadas
docker system prune -a

# Programar limpieza semanal
echo "0 3 * * 0 docker system prune -af" | crontab -

Límites de Recursos

Configura por app en compose:

services:
  app:
    deploy:
      resources:
        limits:
          memory: 512M
          cpus: '0.5'

Acceso a la API

Dokploy tiene una API REST:

# Obtén el token de autenticación desde la configuración

# Listar proyectos
curl -X GET https://dokploy.tudominio.com/api/projects \
  -H "Authorization: Bearer TU_TOKEN"

# Disparar un despliegue
curl -X POST https://dokploy.tudominio.com/api/application/deploy \
  -H "Authorization: Bearer TU_TOKEN" \
  -d '{"applicationId": "xxx"}'

Preguntas Frecuentes

¿Cuántas aplicaciones puede gestionar Dokploy?

En un VPS de 4GB: entre 5 y 15 aplicaciones ligeras cómodamente. Más con límites de recursos adecuados.

¿Está Dokploy listo para producción?

Sí, se mantiene activamente y se usa en producción. La versión v0.8+ es estable.

¿Dokploy vs Coolify?

Ambos son excelentes. Dokploy tiene una UI más sencilla, Coolify tiene más funcionalidades. Prueba ambos.

¿Puedo migrar desde Heroku?

¡Sí! Añade tu repositorio, configura buildpacks o Dockerfile y despliega.

¿Cómo actualizo Dokploy?

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

El mismo comando actualiza a la última versión.

Resumen

Dokploy convierte un VPS de $5 en una potente plataforma de despliegue:

Lo Que Obtienes	Coste
Aplicaciones ilimitadas	Solo el coste del VPS
SSL automático	Incluido
Despliegues con Git	Incluido
Bases de datos	Incluido
Dominios personalizados	Ilimitados

Configuración Recomendada:

1. Obtén un VPS de Hostinger ($4.99/mes)
2. Instala Dokploy
3. Conecta GitHub
4. Despliega todo

Eso es $5 al mes para tener tu propio Vercel. Sin límites, sin dependencia de proveedores, control total.