Problemas frecuentes con Dokploy y cómo resolverlos

Los comandos de esta guía se ejecutan en tu VPS por SSH como root (cómo acceder).

El panel no carga

• Si acabas de contratarlo, Dokploy termina de instalarse unos minutos después del primer correo. Espera al correo «Tu Dokploy está listo» o a que el apartado «Tu aplicación» de tu panel muestre los datos. Si pasada una hora sigue igual, abre un ticket.
• Si funcionaba, comprueba los servicios de Dokploy y su proxy:

docker service ls
docker ps | grep traefik

dokploy, dokploy-postgres y dokploy-redis deben aparecer con 1/1. El motivo de un fallo suele estar en docker service logs --tail 80 dokploy.

• Comprueba con ufw status que los puertos 80 y 443 siguen abiertos.

El panel responde en http://IP:3000

Si el certificado HTTPS no estaba listo al terminar la instalación, el panel queda accesible un rato en el puerto 3000. Es temporal: ese acceso se cierra solo en cuanto HTTPS funciona. Entra por la dirección con HTTPS en cuanto puedas.

He olvidado la contraseña

Localiza el contenedor del panel (el que se llama dokploy. seguido de un identificador, no traefik, postgres ni redis):

docker ps --format '{{.ID}}  {{.Names}}' | grep 'dokploy\.'

Y genera una contraseña nueva con su identificador:

docker exec -it ID_DEL_CONTENEDOR bash -c "pnpm run reset-password"

El comando muestra la contraseña nueva. Cámbiala por una tuya al entrar.

He perdido la verificación en dos pasos

Con el mismo contenedor:

docker exec -it ID_DEL_CONTENEDOR bash -c "pnpm run reset-2fa"

Mi aplicación da error 502 o no arranca

Es lo más habitual al empezar. Revisa en Dokploy los registros del despliegue y de la aplicación. La causa más frecuente es que el puerto interno del dominio no coincide con el puerto en el que escucha tu aplicación. Los errores de tu código no los depuramos, pero sí te ayudamos si es el servidor el que falla.

Un puerto queda abierto aunque no está en el cortafuegos

Es el comportamiento normal de Docker: los puertos que se publican desde Docker o Dokploy no pasan por ufw. Publica solo los imprescindibles y sirve tus aplicaciones por dominio a través de Dokploy.

El disco se llena

Las imágenes y compilaciones de Docker ocupan mucho. Activa la limpieza automática en Settings → Web Server y mira qué ocupa más con:

docker system df
df -h /

Se queda sin memoria durante las compilaciones

Las compilaciones son el pico de consumo. Compila menos a menudo, para las aplicaciones que no uses o compila fuera (por ejemplo en tu sistema de integración continua) y despliega la imagen ya hecha. Si el consumo es de tu uso normal, sube de plan sin perder nada.

Qué cubre el soporte

Te ayudamos con el VPS y con la instalación de Dokploy: que el servidor y el panel funcionen, el acceso inicial y los pasos de estas guías. El código y los despliegues de tus aplicaciones son tuyos; para eso tienes la documentación oficial de Dokploy. Si algo del servidor no va, abre un ticket y, por seguridad, no pegues contraseñas.

Relacionado

• Dónde están los datos de acceso de tu aplicación
• Usar tu propio dominio en Dokploy
• Cómo actualizar Dokploy en tu VPS

Contratar: VPS con Dokploy en Frankfurt · en Miami