Capitulo 1: Que es Dokploy

Por: Artiko
dokploypaasself-hostedintroduccion

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

CaracteristicaDokployVercelNetlifyHerokuCoolify
PrecioGratisFreemiumFreemiumDe pagoGratis
Self-hostedSiNoNoNoSi
Open sourceSiNoNoNoSi
Bases de datosIntegradasLimitadasNoAdd-onsIntegradas
Docker ComposeSiNoNoNoSi
Docker SwarmSiNoNoNoNo
SSL automaticoLet’s EncryptIncluidoIncluidoIncluidoLet’s Encrypt
Templates382+LimitadosLimitadosNoLimitados
MonitoringIntegradoBasicoBasicoAdd-onsIntegrado
SSO/2FASiSiSiSiSi
CLI@dokploy/clivercel-clinetlify-cliheroku-cliNo
Build methodsNixpacks, Dockerfile, BuildpacksPropioPropioBuildpacksNixpacks, 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.


Siguiente: Capitulo 2: Requisitos y Preparacion del VPS —>