Cómo instalar Dokploy en tu VPS

Instala Dokploy, el panel de despliegue de código abierto, en un VPS con un solo comando, crea la cuenta de administración y ponle dominio y HTTPS al panel.

Dokploy es un panel de despliegue de código abierto que corre en tu propio VPS: subes tu código o conectas tu repositorio, y él construye la imagen, la publica con tu dominio y renueva el certificado. Es la alternativa autoalojada a Vercel o Heroku, y se instala con un comando.

Antes de empezar

• Para quién es este manual. Para un VPS autogestionado (no administrado), donde el sistema y el software los instalas y los mantienes tú. Si tu VPS es administrado, no sigas estos pasos: Dokploy se ofrece bajo consulta y acuerdo previo, lo instalamos nosotros y mantenemos el sistema operativo y el servidor; pídelo por ticket (Cómo abrir un ticket de soporte y que se resuelva a la primera). En administrado y gestionado, además, operamos la plataforma dentro del alcance acordado. En las tres modalidades, los repositorios, la configuración de tu aplicación y sus despliegues siguen siendo tuyos o de tu desarrollador (¿Cúal es la diferencia entre un VPS administrado y un VPS no administrado?).
• Un VPS con Ubuntu 24.04 LTS recién instalado (Cómo reinstalar el sistema operativo de tu VPS), acceso SSH como root y al menos 2 GiB de memoria (4 GiB si vas a construir imágenes en el propio servidor).
• Los puertos 80, 443 y 3000 tienen que estar libres: el instalador se niega a continuar si algo escucha en ellos. Por eso conviene hacerlo en un servidor limpio, antes de instalar nada más.
• Docker no hace falta instalarlo antes: el instalador lo hace si no está (Cómo instalar Docker y Docker Compose en tu VPS). Si ya lo tienes, lo aprovecha.

Paso a paso

1. Entra por SSH y ejecuta el instalador oficial:

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

Instala Docker si falta, activa Docker Swarm, y arranca tres servicios: la base de datos PostgreSQL de Dokploy, el proxy Traefik (que atiende los puertos 80 y 443) y el propio panel en el puerto 3000. Tarda entre dos y cuatro minutos.

2. Al terminar muestra «Congratulations, Dokploy is installed!» y la dirección del panel: http://tu-ip:3000. Espera quince segundos y ábrela en el navegador.

3. La primera visita muestra Setup the server: el formulario para crear la cuenta de administración. Rellena nombre, apellidos, correo y una contraseña larga y pulsa Register. Solo se puede crear una vez; después, esa pantalla pasa a ser la de inicio de sesión.

4. Entras directamente al panel, con un asistente de cuatro pasos (Welcome, New project, Ship something, You're live). Puedes seguirlo o pulsar SKIP ALL y hacerlo a tu ritmo con Cómo desplegar tu primera aplicación en Dokploy.

5. Antes de nada, protege el panel con tu dominio y HTTPS. Crea un registro A en la zona DNS de tu dominio (por ejemplo panel.tudominio.es) apuntando a la IP del VPS (Cómo crear un registro DNS (A, CNAME, MX o TXT)). Después, en Settings → Web Server, escribe ese dominio, tu correo para Let's Encrypt, activa HTTPS y pulsa Save.

6. En uno o dos minutos el panel responde en https://panel.tudominio.es con certificado válido. A partir de ahí, usa siempre esa dirección.

Cómo comprobar que ha funcionado

Por SSH, docker service ls muestra dokploy y dokploy-postgres con 1/1 en la columna REPLICAS, y docker ps incluye el contenedor dokploy-traefik con los puertos 80 y 443. Y el panel abre con tu dominio y el candado del navegador.

Si algo falla

• «Error: something is already running on port 80»: hay un servidor web (Apache, nginx) o un contenedor ocupando el puerto. Páralo o, si el VPS es autogestionado, reinstálalo y empieza en limpio (Cómo reinstalar el sistema operativo de tu VPS).
• El panel no responde en el 3000: espera un minuto más y prueba docker service ls; si dokploy no llega a 1/1, revisa la memoria con free -h.
• El certificado no llega: el registro DNS no apunta todavía a la IP del VPS, o lo has creado hace menos de unos minutos. Compruébalo con dig +short panel.tudominio.es.
• Cualquier otra cosa: abre un ticket desde tu área de cliente (Cómo abrir un ticket de soporte y que se resuelva a la primera). En un VPS administrado, el sistema y la instalación de Dokploy son nuestros; en uno autogestionado te orientamos, pero el panel es tuyo. Lo que despliegues dentro es tuyo en cualquier modalidad.

Relacionados

• Cómo instalar Docker y Docker Compose en tu VPS
• Cómo desplegar tu primera aplicación en Dokploy
• Cómo poner dominio y HTTPS a una aplicación en Dokploy
• Cómo reinstalar el sistema operativo de tu VPS