Dockge: Por qué cambié Portainer por esta herramienta ligera (y la recomiendo)

Si te ocupas de self-hosting, tienes un laboratorio doméstico o administras un VPS pequeño, seguramente conoces Portainer. Es el estándar de facto: una navaja suiza potente y completa para Docker.

Pero seamos honestos: a veces la navaja suiza es demasiado pesada cuando solo necesitas pelar una manzana.

Recientemente descubrí Dockge — una herramienta del mismo desarrollador del popular Uptime Kuma. Me hizo replantear por completo el enfoque para gestionar contenedores. En este artículo cuento por qué Dockge puede ser el reemplazo ideal de Portainer para muchos escenarios.

El problema con Portainer

Me gusta Portainer. Hace de todo: Kubernetes, Swarm, gestión de imágenes, redes y volúmenes. Pero hay una característica fundamental que a menudo resulta molesta: oculta la configuración.

Cuando creas un “Stack” en Portainer, tu docker-compose.yaml vive en su base de datos interna. Si Portainer se cae o la base de datos se corrompe, las configuraciones están en riesgo. Claro, se puede conectar un repositorio Git, pero eso añade un paso extra a un proceso simple.

¿Qué es Dockge?

Dockge (se pronuncia como «Dodge» — de Docker + Dodge) — es un gestor reactivo, moderno e increíblemente ligero para docker-compose.yaml.

Su filosofía principal: Tus archivos — la fuente de la verdad.

A diferencia de Portainer, Dockge no oculta las configuraciones en su BD. Simplemente lee y gestiona carpetas con compose.yaml en el disco. Elimina Dockge — los contenedores y las configuraciones permanecen en su lugar, ordenados en carpetas.

5 razones para pasarse a Dockge

Aquí las características clave que me hicieron migrar:

1. La estructura de archivos — la base de todo
   Dockge trabaja directamente con el sistema de archivos.

   • Creas la carpeta /opt/stacks.
   • Dockge la escanea.
   • Creas manualmente /opt/stacks/my-app con compose.yaml dentro — Dockge ve el nuevo stack al instante.
   • Editas el archivo en el terminal (vim/nano) — los cambios se reflejan de inmediato en la interfaz.

2. Convertidor docker run → Compose
   ¡Función estrella! ¿Cuántas veces has encontrado un proyecto en GitHub con una enorme línea docker run ...?
   En Dockge pegas ese comando en un campo especial — y obtienes un YAML válido listo. Nada de conversión manual.

3. Editor interactivo
   Enfoque híbrido: a la izquierda — código YAML limpio, a la derecha — campos visuales (puertos, volúmenes, env). Modificas uno — se sincroniza el otro. Funciona de forma increíblemente fluida.

4. Ligereza y velocidad (Interfaz reactiva)
   Si has usado Uptime Kuma, conoces esa interfaz agradable. Dockge está construido con las mismas tecnologías: respuesta instantánea, mínimo de clics, sin retardos.

5. Soporte para múltiples servidores (agentes)
   Dockge permite gestionar múltiples hosts Docker desde una sola interfaz, manteniendo la simplicidad de configuración.

Comparación: Dockge vs Portainer

¿Cómo instalar Dockge?

La instalación — una demostración clara de la filosofía del proyecto: mínimos pasos.

# 1. Crear directorios
mkdir -p /opt/stacks /opt/dockge
cd /opt/dockge

# 2. Descargar el compose.yaml oficial
curl https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml --output compose.yaml

# 3. Ejecutar
docker compose up -d

Abre http://ip-de-tu-servidor:5001 — ¡y listo!

Consejo: Si migras desde Portainer y tus archivos compose ya están en disco — simplemente indica a Dockge la ruta a esa carpeta, y recogerá los stacks al instante.

Conclusión: ¿Vale la pena cambiar?

Quédate con Portainer si:

• Gestionas clústeres Kubernetes o Docker Swarm.
• Necesitas RBAC complejo (roles y permisos).
• Requieres control detallado desde la GUI sobre imágenes y volúmenes individuales.

Cámbiate a Dockge si:

• Tienes uno o varios VPS/servidores domésticos.
• Te gusta el orden en el sistema de archivos.
• Quieres que la interfaz ayude en vez de entorpecer.
• Estás cansado del “peso” de Portainer para ejecutar una decena de contenedores.

Dockge me devolvió la alegría de configurar contenedores. Es una herramienta que hace una cosa, pero la hace a la perfección: gestiona archivos docker-compose. Pruébalo — quizás tu Portainer también vaya a una merecida jubilación.

🛠 Guía: Migración sin dolor de Portainer a Dockge

A muchos les frena el miedo a romper servicios en funcionamiento. ¡Tranquilo! Los contenedores están aislados de la herramienta de gestión, la migración es suave.

Paso 0: Preparación y copia de seguridad
Asegúrate de dónde se almacenan los datos de los contenedores (volúmenes).

• Bind mounts (/path/on/host:/path/in/container) — los datos están en el disco, seguros.
• Named volumes — dentro de Docker, no desaparecerán al recrearlos.

Haz copia de seguridad de los datos importantes o un snapshot del servidor.

Paso 1: Exportar la configuración desde Portainer

1. Ve a Stacks → selecciona el stack → Editor.
2. Copia todo el YAML al portapapeles.

Paso 2: Detención en Portainer

1. Detén el stack.
2. Opcional: elimina el stack más tarde, cuando estés seguro de que todo funciona en Dockge (¡no borres los volúmenes!).

Paso 3: Despliegue en Dockge

1. Abre Dockge (http://ip:5001).

2. Pulsa + Compose → introduce el nombre del stack.

3. Pega el YAML copiado.

4. Revisa las rutas de los volúmenes:

   • Las rutas relativas (./data) serán relativas a la carpeta del stack en Dockge (/opt/stacks/<name>/).
   • Recomiendo usar rutas absolutas o mover los datos.

5. Guardar → Desplegar.

¿Contenedores individuales (no en stacks)?

1. Compose → pega el comando docker run ... en el campo del convertidor.
2. Dockge creará el YAML automáticamente → Desplegar.

¡Listo! Ahora tus configs están en archivos de texto normales, y no en la “caja negra” de una base de datos.

¡Buena suerte con la migración!