Capitulo 1: Que es Dokploy
Capitulo 1: Que es Dokploy
< Volver al Indice del Tutorial
Que es Dokploy
Dokploy es una plataforma PaaS (Platform as a Service) open source y self-hosted que permite desplegar aplicaciones, bases de datos y servicios en tu propio servidor. Con mas de 31.1k estrellas en GitHub y en su version v0.28.1, se posiciona como la alternativa gratuita a servicios como Vercel, Netlify y Heroku.
La propuesta es simple: un solo comando de instalacion y tienes un panel completo para gestionar tus deploys, dominios, SSL, bases de datos y monitoring.
curl -sSL https://dokploy.com/install.sh | sh
Con eso obtienes un panel web funcional corriendo en el puerto 3000 de tu servidor.
Arquitectura Interna
Dokploy no es un monolito simple. Esta compuesto por cuatro componentes principales que trabajan en conjunto.
Next.js - Panel de Control
El frontend y backend del panel estan construidos con Next.js. Esto incluye:
- La interfaz web donde gestionas proyectos, aplicaciones y bases de datos.
- Las API routes que procesan las acciones del usuario.
- Server-side rendering para carga rapida del dashboard.
- Autenticacion, roles y permisos integrados.
El panel corre como un contenedor Docker y es el punto de entrada principal para interactuar con Dokploy.
PostgreSQL - Base de Datos Principal
PostgreSQL almacena toda la informacion del sistema:
- Configuraciones de proyectos y aplicaciones.
- Usuarios, roles y permisos.
- Historial de deployments.
- Configuraciones de dominios y certificados.
- Estado de las bases de datos gestionadas.
Dokploy usa PostgreSQL internamente para su propio estado; las bases de datos que tu despliegues para tus aplicaciones son instancias separadas.
Redis - Cache y Colas
Redis maneja dos funciones criticas:
- Cache: Almacena datos temporales para mejorar la velocidad del panel.
- Colas de trabajo: Los builds y deploys se encolan en Redis y se procesan de forma asincrona. Esto permite que el panel responda inmediatamente mientras el build ocurre en segundo plano.
Traefik - Reverse Proxy
Traefik es el componente que expone tus aplicaciones al mundo:
- Routing automatico: Cuando despliegas una aplicacion y le asignas un dominio, Traefik configura la ruta automaticamente.
- SSL gratuito: Genera y renueva certificados Let’s Encrypt sin intervencion manual.
- Load balancing: Distribuye trafico entre multiples instancias si usas Docker Swarm.
- Middleware: Permite agregar headers de seguridad, redirects y rate limiting.
Diagrama de Componentes
Internet
|
[Traefik]
/ | \
[Panel] [App1] [App2]
Next.js
| \
[PostgreSQL] [Redis]
Traefik recibe todo el trafico entrante y lo enruta al panel de Dokploy o a las aplicaciones desplegadas segun el dominio configurado.
Comparativa con Alternativas
| Caracteristica | Dokploy | Vercel | Netlify | Heroku | Coolify |
|---|---|---|---|---|---|
| Precio | Gratis | Freemium | Freemium | De pago | Gratis |
| Self-hosted | Si | No | No | No | Si |
| Open source | Si | No | No | No | Si |
| Bases de datos | Integradas | Limitadas | No | Add-ons | Integradas |
| Docker Compose | Si | No | No | No | Si |
| Docker Swarm | Si | No | No | No | No |
| SSL automatico | Let’s Encrypt | Incluido | Incluido | Incluido | Let’s Encrypt |
| Templates | 382+ | Limitados | Limitados | No | Limitados |
| Monitoring | Integrado | Basico | Basico | Add-ons | Integrado |
| SSO/2FA | Si | Si | Si | Si | Si |
| CLI | @dokploy/cli | vercel-cli | netlify-cli | heroku-cli | No |
| Build methods | Nixpacks, Dockerfile, Buildpacks | Propio | Propio | Buildpacks | Nixpacks, Dockerfile |
Dokploy vs Vercel/Netlify
Vercel y Netlify son excelentes para proyectos frontend y funciones serverless. Si tu stack es Next.js puro sin backend propio, Vercel es dificil de superar. Pero si necesitas bases de datos, servicios backend, Docker Compose o control total sobre la infraestructura, Dokploy es la opcion.
Dokploy vs Heroku
Heroku elimino su tier gratuito en 2022. Los precios escalan rapido con dynos y add-ons. Con Dokploy pagas solo el VPS (desde 4 USD/mes) y obtienes funcionalidad equivalente o superior.
Dokploy vs Coolify
Coolify es el competidor directo mas cercano. Ambos son open source y self-hosted. Las diferencias principales:
- Dokploy soporta Docker Swarm nativamente; Coolify no.
- Dokploy tiene mas templates preconfigurados (382+).
- Coolify tiene una interfaz ligeramente mas pulida en algunos aspectos.
- Dokploy ofrece CLI oficial (
@dokploy/cli).
Ambos son opciones solidas. La eleccion depende de preferencias de interfaz y features especificos.
Ventajas del Self-Hosting
Control total sobre los datos
Tus aplicaciones, bases de datos y logs viven en tu servidor. No dependes de la politica de privacidad de un tercero ni de cambios unilaterales en terminos de servicio.
Costos predecibles
Un VPS de 4-8 USD/mes puede correr multiples aplicaciones que en Vercel o Heroku costarian 50+ USD/mes. El costo no escala con el numero de deploys o el tiempo de build.
Sin vendor lock-in
Dokploy usa tecnologias estandar (Docker, Traefik, PostgreSQL). Si decides migrar, tus contenedores Docker funcionan en cualquier lugar.
Flexibilidad completa
Puedes instalar cualquier software en tu servidor, configurar redes internas, montar volumenes personalizados y ejecutar procesos que los PaaS comerciales no permiten.
Casos de Uso Ideales
Startups y proyectos personales
Un VPS barato con Dokploy permite correr el backend, frontend, base de datos y servicios auxiliares desde un solo lugar con SSL automatico.
Equipos pequenos
El sistema de roles y permisos permite que multiples desarrolladores desplieguen sin acceso directo al servidor. El panel centraliza la gestion.
Entornos de staging
Dokploy facilita tener multiples entornos (staging, QA, demo) en un solo servidor, cada uno con su propio dominio y base de datos.
Aplicaciones con bases de datos
Si tu proyecto necesita PostgreSQL, MySQL, MongoDB o Redis, Dokploy los gestiona como servicios integrados con backups automaticos.
Docker Compose existente
Si ya tienes un docker-compose.yml funcional, Dokploy puede desplegarlo directamente sin modificaciones.