Instalar Dokploy en un contenedor LXC de Proxmox
Cómo preparo un LXC sin privilegios para Docker, instalo Dokploy y dejo el panel accesible solo en la red local hasta tener dominio y HTTPS.
Dokploy es una plataforma de código abierto para desplegar aplicaciones con Docker: le das un repositorio, un Dockerfile o un archivo comprimido y se encarga de construir, levantar el contenedor, configurar el proxy y pedir el certificado HTTPS. Es parecido a lo que ofrecen servicios como Heroku o Vercel, pero corriendo en tu propio servidor.
En mi laboratorio, Dokploy vive dentro de un contenedor LXC de Proxmox. Esta guía cuenta cómo lo preparé.
Por qué en LXC y no en una VM
La recomendación general para Docker en Proxmox es una máquina virtual. Yo elegí LXC por memoria: en un host de 12 GB, cada gigabyte cuenta. Funciona, pero tiene un problema conocido con la red de Docker Swarm que conviene leer antes de empezar: está en el error 502 y el truco de dnsrr.
Crear el contenedor
Mis valores:
- Plantilla: Debian 13.
- Unprivileged: sí.
- Núcleos: 4 (todos los del host; LXC los comparte, no los reserva).
- RAM: 8 GB, swap 512 MB.
- Disco: 40 GB en el SSD (
local-lvm). Las imágenes Docker ocupan rápido. - Red: IP fija en el puente
vmbr0, por ejemplo10.20.30.10/24. - Start at boot: sí.
Antes de arrancarlo, en Options → Features, activá nesting y keyctl. Por consola:
pct set 103 --features nesting=1,keyctl=1
pct start 103
Preparar el sistema
Entrá al contenedor (pct enter 103) y dejalo actualizado:
apt update && apt full-upgrade -y
apt install -y curl ca-certificates
timedatectl set-timezone America/Argentina/Buenos_Aires
Instalar Dokploy
El método oficial es un script de instalación. Mi consejo: bajalo, leelo y después ejecutalo, en lugar de pasarlo directo a sh.
curl -sSL https://dokploy.com/install.sh -o install-dokploy.sh
less install-dokploy.sh
sh install-dokploy.sh
El script instala Docker si no está, inicializa Docker Swarm, crea la red dokploy-network y levanta los servicios: el panel, PostgreSQL, Redis y Traefik como proxy de borde.
Cuando termina, el panel queda en el puerto 3000: http://10.20.30.10:3000. Ahí creás la cuenta de administrador. Hacelo enseguida: hasta que exista ese usuario, cualquiera que llegue al puerto puede crearla.
El panel, solo en la red local
Que el panel responda en el puerto 3000 por HTTP está bien para la configuración inicial, en tu red. Lo que no hay que hacer es redirigir ese puerto desde el router a internet. Mi política es simple: a internet solo salen los puertos 80 y 443, y todo pasa por Traefik con HTTPS. Lo explico en solo 80 y 443.
Cuando tengas un dominio, en Settings → Web Server podés asignarle un nombre al panel (por ejemplo panel.ejemplo.com.ar) con certificado de Let’s Encrypt. A partir de ahí entrás por HTTPS. Yo además lo protegí con una lista de IPs permitidas, como cuento en esta guía.
Zona horaria de los servicios
Los contenedores Docker usan UTC por defecto. Si una aplicación muestra horas o programa tareas, agregá la variable de entorno TZ=America/Argentina/Buenos_Aires en su configuración dentro de Dokploy.
Comprobaciones
Desde el contenedor:
docker node ls
docker service ls
Deberías ver un nodo en estado Ready y los servicios de Dokploy con réplicas 1/1. Si Traefik está, pero las aplicaciones que despliegues devuelven 502, no es tu aplicación: es el problema de red de Swarm dentro de LXC, y se resuelve con un ajuste por aplicación.
Backups
El contenedor entra en el backup nocturno de Proxmox como cualquier otro. Dokploy además tiene su propio sistema de backups de bases de datos hacia almacenamiento S3, que vale la pena configurar si guardás datos importantes en alguna aplicación.