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

Dockge — una interfaz web ligera para gestionar stacks de Docker Compose. No guarda la configuración en su propia base: cada stack es simplemente una carpeta con un archivo compose.yaml en el disco, y Dockge permite crear, editar, arrancar y detener esos stacks desde el navegador. Lo escribió el autor de Uptime Kuma; el proyecto se distribuye bajo la licencia MIT.

Usé Portainer durante mucho tiempo y cambié a Dockge para mis servidores. Más abajo: por qué, qué se pierde al hacerlo y cómo migrar los stacks sin tiempo de inactividad.

Qué no me convencía de Portainer

Portainer sabe hacer muchas cosas: Kubernetes, Swarm, imágenes, redes, volúmenes, roles de usuario. Pero tiene una particularidad que molesta en instalaciones pequeñas: los stacks creados a través de la interfaz viven dentro de Portainer. El archivo docker-compose.yaml no está en un lugar claro del disco, no se puede abrir simplemente en un editor ni poner en Git sin configuración adicional.

Para uno-tres servidores con una decena de servicios necesitaba el esquema contrario: los archivos como fuente principal de verdad, y la interfaz como comodidad encima de ellos.

Cómo está diseñado Dockge

• Archivos en disco. Por defecto los stacks están en /opt/stacks (la ruta se define con la variable DOCKGE_STACKS_DIR). Creas manualmente /opt/stacks/myapp/compose.yaml — Dockge detectará el nuevo stack. Editas el archivo en la terminal — los cambios se ven en la interfaz.
• Desinstalar Dockge no rompe nada. Los contenedores y los archivos quedan en su sitio, y se pueden gestionar con el habitual docker compose.
• Editor de compose.yaml con sugerencias y terminal web.
• Convertidor docker run → compose.yaml: pegas el comando del README de un proyecto y obtienes un archivo listo.
• Varios hosts. Desde la versión 1.4.0 Dockge puede conectar agentes y gestionar stacks en varios hosts Docker desde una sola ventana.

Sobre el desarrollo del proyecto

Dockge se desarrolla despacio: la última versión es 1.5.0 de marzo de 2025, los cambios en el repositorio aparecen con poca frecuencia. Para una herramienta que solo gestiona archivos Compose esto no es crítico — los stacks seguirán funcionando pase lo que pase con el proyecto. Pero si necesitas nuevas funciones y soporte activo, conviene tenerlo en cuenta.

Instalación

Requisitos según el README: Docker 20+ (o Podman), Linux — Ubuntu, Debian Bullseye y posteriores, CentOS, Fedora, Arch; arquitecturas amd64, arm64, armv7. Windows no está soportado.

mkdir -p /opt/stacks /opt/dockge
cd /opt/dockge
curl https://raw.githubusercontent.com/louislam/dockge/master/compose.yaml --output compose.yaml
docker compose up -d

La interfaz se abre en el puerto 5001: http://адрес-сервера:5001. Al entrar por primera vez se crea una cuenta de administrador.

Actualizar — desde el mismo directorio:

cd /opt/dockge
docker compose pull && docker compose up -d

No conviene abrir el puerto 5001 a Internet: con Dockge se pueden ejecutar contenedores arbitrarios, es decir, controlar el servidor. Acceso mediante VPN, túnel SSH o proxy inverso con autenticación.

Dockge o Portainer

Qué se pierde al cambiar: gestión de Kubernetes y Swarm, roles de usuario, gestión detallada de imágenes, redes y volúmenes desde la interfaz. Si necesitas eso, quédate en Portainer.

Cuándo Dockge es mejor: varios VPS o un servidor doméstico, todo descrito en Compose, quieres mantener los archivos en directorios claros y editarlos tanto desde la interfaz como desde la terminal.

Migración de stacks desde Portainer

Los contenedores no dependen de con qué se gestionen, por eso la migración se hace sin pérdida de datos — si se es cuidadoso con los volúmenes.

1. Comprueba dónde están los datos. Los directorios vinculados (/ruta/en/el/host:/ruta/en/el/contenedor) permanecen en el disco. Los volúmenes con nombre de Docker también se conservan al recrear el contenedor. Antes de migrar, haz copia de seguridad de los datos importantes o un snapshot del servidor.
2. Copia el YAML del stack en Portainer: Stacks → стек → Editor.
3. Detén el stack en Portainer. No lo borres junto con los volúmenes hasta comprobar que en Dockge todo funciona.
4. Crea el stack en Dockge: «+ Compose», nombre del stack, pegar el YAML, Save y Deploy.
5. Verifica las rutas. Las rutas relativas como ./data ahora se interpretan desde el directorio del stack /opt/stacks/<nombre>/. Es más fiable indicar rutas absolutas a los datos anteriores o mover el directorio.
6. Contenedores individuales sin stack se migran con el convertidor: pega el comando docker run en el campo del convertidor, obtendrás compose.yaml y lo despliegas.

Si tus archivos Compose ya están en el disco, basta colocarlos en carpetas dentro del directorio de stacks — Dockge los detectará automáticamente.

Resumen

Dockge hace una cosa: gestionar archivos Docker Compose — y lo hace de forma cómoda, sin apropiarse de tu configuración. A mí me basta para mis servidores. Para clústeres, equipos con separación de permisos y gestión detallada de recursos Docker sigue siendo necesario Portainer, y conviene tener presente el lento ritmo de desarrollo de Dockge.