Cómo instalar Dockman en Docker - Gestor de Docker Compose autohospedado en Docker

Dockman | Docker Compose Manager | Docker

Dockman: Gestor web moderno de Docker Compose autohospedado en Docker para homelabs

UI web para gestionar Docker Compose. Editor visual YAML. Multi-host (SSH). Control contenedores. Imágenes, volúmenes, networks. Búsqueda. Atajos teclado. Dark mode. TypeScript + React. AGPL-3.0 open source.

¿Qué es Dockman?

Dockman es una interfaz web moderna y accesible para gestionar docker-compose de forma visual, diseñada específicamente para homelabs que quieren control total sobre sus archivos .yaml sin perder la comodidad de una UI intuitiva. A diferencia de Portainer (que abstrae Compose), Dockman mantiene tus archivos Compose como fuente de verdad mientras proporciona gestión visual.

Propuesta clave: Acceso directo a archivos docker-compose en tu filesystem. Editor visual YAML (no oculta nada). Gestión de stacks por carpetas o archivos individuales. Multi-host support via SSH (gesiona múltiples servidores). Control completo de contenedores (start, stop, restart, logs, shell). Gestión de imágenes, volúmenes, networks. Búsqueda instant de containers/imágenes. Atajos teclado (Alt+L para YAML format). Dark mode. Responsive design (mobile, tablet, desktop). Sistema de configuración .dockman.yml. Persistencia en BD local. UI moderna con React + TypeScript. AGPL-3.0 open source.

Características principales: Gestor visual de docker-compose files. Smart detect de compose files (promociona files únicos a nivel top). Editor YAML con formatting (Alt+L). Interfaz split-panel (file browser + editor). Control containers: start, stop, restart, logs, shell. Busca y atajos para containers/imágenes. Gestión imágenes (pull, remove, tags). Gestión volúmenes y networks. Multi-host vía SSH (gesiona múltiples servidores desde UI central). Configuración centralizada (.dockman.yml). Base datos SQLite para persistencia. Dark mode + light mode. Responsive (mobile-friendly). Keyboard shortcuts (navegación rápida). Soporte múltiples rutas Compose (DOCKMAN_COMPOSE_ROOT). Docker run simplísimo. Desarrollo activo (releases frecuentes). Comunidad activa en GitHub.

Para homelabs: Gestor Compose visual sin perder control. Datos tuyos. Open source. TypeScript limpio y moderno.

Características principales

Gestor visual docker-compose

Editor YAML. Interfaz intuitiva. Mantén control archivos.

Smart compose detection

Promociona compose files únicos. Folders con múltiples files como directorios.

Control containers

Start, stop, restart, logs, shell, rm. Control completo.

Gesión de imágenes

Pull, remove, tags, search. Gestión completa.

Multi-host SSH

Gestiona múltiples servidores vía SSH. Centralizado.

Gestión volúmenes/networks

Crea, elimina, inspecciona. Control total.

Búsqueda + atajos

Encuentra containers/imágenes instant. Keyboard shortcuts rápidos.

Editor YAML formatter

Alt+L para format. Edita sin salir UI.

Dark mode + Responsive

UI moderna. Desktop, tablet, móvil. Eye-friendly.

Configuración .dockman.yml

Setup centralizado. Aliases para directorios externo.

Persistencia BD

SQLite local. Configuración guardada. Hosts, SSH keys.

AGPL-3.0 open source

Código accesible. Comunidad activa. Desarrollo continuo.

Requisitos del sistema

• Docker & Docker Socket (/var/run/docker.sock accesible)
• 100 MB - 500 MB RAM (ligero, NodeJS)
• 100 MB espacio disco (para imagen + BD config)
• Puerto 8866 o custom (configurable)
• Volumen persistente para /config (BD, SSH keys)
• DOCKMAN_COMPOSE_ROOT env var (ruta a compose files)
• Navegador moderno (Chrome, Firefox, Safari, Edge)

Nota importante: La ruta COMPOSE_ROOT debe ser ABSOLUTA e idéntica en: env var + volumen host + volumen container.

Instalación con Docker Compose

Paso 1: Preparar estructura directorios

mkdir -p /ruta/absoluta/stacks mkdir -p /ruta/absoluta/dockman/config # /ruta/absoluta/stacks contendrá tus docker-compose.yml files

Paso 2: Docker Compose (recomendado)

cat > docker-compose.yml << 'EOF' version: '3.8' services: dockman: container_name: dockman image: ghcr.io/ra341/dockman:latest restart: always ports: - "8866:8866" environment: # 1️⃣ Ruta absoluta a tus compose files - DOCKMAN_COMPOSE_ROOT=/ruta/absoluta/stacks # Desactivar warning auth (si no usas auth) - DOCKMAN_LOG_AUTH_WARNING=false volumes: # 2️⃣ Host side y 3️⃣ Container side DEBEN SER IDÉNTICAS - /ruta/absoluta/stacks:/ruta/absoluta/stacks # Config dir (BD, SSH keys, etc) - /ruta/absoluta/dockman/config:/config # Docker socket para gestionar containers - /var/run/docker.sock:/var/run/docker.sock EOF docker compose up -d

Paso 3: Docker run simple

docker run -d \ --name dockman \ --restart always \ -p 8866:8866 \ -e DOCKMAN_COMPOSE_ROOT=/ruta/absoluta/stacks \ -e DOCKMAN_LOG_AUTH_WARNING=false \ -v /ruta/absoluta/stacks:/ruta/absoluta/stacks \ -v /ruta/absoluta/dockman/config:/config \ -v /var/run/docker.sock:/var/run/docker.sock \ ghcr.io/ra341/dockman:latest

Acceder

http://localhost:8866 - Dashboard Dockman

Verificar estado

docker logs dockman docker ps | grep dockman

Primeros pasos

1. Acceder por primera vez

1. Abre http://localhost:8866
2. Verás dashboard de Dockman
3. File browser en izquierda, editor en derecha
4. Auto-detecta tus docker-compose files desde DOCKMAN_COMPOSE_ROOT

2. Crear primer stack (compose file)

1. File browser → click "+ Add File"
2. Nombre: "docker-compose.yml"
3. Editor abre con template vacío
4. Copia-pega tu compose YAML
5. Auto-save

3. Gestionar contenedores

1. Dashboard → "Containers" tab
2. Verás todos containers corriendo
3. Click container → opciones: logs, shell, restart, stop, rm
4. Control completo visual

4. Ver logs en tiempo real

1. Containers → click container → "Logs"
2. Terminal abierta con logs streaming
3. Scroll automático, búsqueda rápida

5. Shell interactivo en container

1. Containers → click container → "Shell"
2. Terminal interactiva se abre
3. Ejecuta comandos directamente
4. Cierra cuando terminas

6. Gestionar imágenes

1. Dashboard → "Images" tab
2. Verás todas imágenes locales
3. Pull nueva: click "Pull" → ingresa imagen name
4. Remove, inspect, tags

7. Editor YAML con format (Alt+L)

1. File browser → click compose file
2. Editor abre
3. Presiona Alt+L para auto-format YAML
4. Edita directamente sin UI abstracta

8. Búsqueda rápida (containers/imágenes)

1. Dashboard → Search bar arriba
2. Escribe nombre container o imagen
3. Resultados instant
4. Atajos teclado para navegación rápida

9. Agregar host remoto (SSH multi-host)

1. Settings (engranaje) → "Hosts"
2. Click "Add Host"
3. Nombre, IP, usuario SSH, puerto (22 default)
4. Copia tu SSH key (o genera nueva)
5. Dockman gestiona múltiples servidores desde UI central

10. Gestión volúmenes/networks

1. Dashboard → "Volumes" o "Networks" tabs
2. Ver todos volúmenes/networks
3. Crear nuevo, remove, inspect
4. Control completo

11. Cambiar tema (Dark mode)

1. Settings → Theme
2. Toggle Dark/Light
3. Preferencia guardada en BD local

Casos de uso

• Homelabs (self-hosted): Gestor visual para tu stack de servicios. Control total. Zero cloud.
• DevOps engineers: Manage múltiples servidores vía SSH. Compose files como source of truth.
• Startups/pequeños equipos: Dashboard compartida. Sin complejidad de Kubernetes. Compose suficiente.
• Learning Docker: Aprende Compose visualmente. Entiende YAML sin abstracciones.
• Migración desde Portainer: Si quieres acceso directo a Compose files pero UI moderna.

HTTPS con Caddy (producción)

Caddyfile

docker.tudominio.com { reverse_proxy localhost:8866 }

Acceso remoto seguro

https://docker.tudominio.com con HTTPS automático

IMPORTANTE: Proteger acceso

Dockman no incluye auth por defecto. Usar Caddy con basic_auth o HTTPS + firewall si expones a red

Gestión y mantenimiento

Ver logs

docker logs -f dockman

Backup de configuración

cp -r /ruta/absoluta/dockman/config ./dockman-config-backup-$(date +%Y%m%d) # Contiene: BD SQLite, SSH keys, settings

Backup de compose files

cp -r /ruta/absoluta/stacks ./stacks-backup-$(date +%Y%m%d)

Restore configuración

docker stop dockman rm -rf /ruta/absoluta/dockman/config cp -r ./dockman-config-backup-YYYYMMDD /ruta/absoluta/dockman/config docker start dockman

Reiniciar container

docker compose restart dockman

Actualizar a versión más reciente

docker compose pull docker compose up -d

Monitorear consumo

docker stats dockman # Típicamente: 100-300MB RAM, bajo CPU

Verificar COMPOSE_ROOT setup

docker exec dockman sh -c 'echo $DOCKMAN_COMPOSE_ROOT' # Debe mostrar tu ruta absoluta configurada

Comparativa con alternativas

vs Portainer

Dockman gana: Acceso directo Compose files, UI moderna, TypeScript limpio. Portainer gana: Más features, Kubernetes, enterprise support.

vs Docker Desktop (GUI)

Dockman gana: Web-based, multi-host, compose-focused. Desktop gana: Native app, más pulida.

vs Coolify/CapRover

Dockman gana: Simple, compose-native, sin abstracciones. Coolify gana: Deployments, domains, Let's Encrypt integrado.

vs Editar YAML manualmente

Dockman gana: UI visual, logs/shell desde browser, multi-host. Manual gana: Control ultra-fino, workflow scriptable.

Mejor para: Homelabs que valoran simplicidad + control total. Compose como source of truth. Sin abstracciones.

---

Referencias oficiales

• GitHub Repository - RA341/dockman
• Official Website - dockman.radn.dev
• Official Documentation
• Docker Hub - ra341/dockman
• GitHub Container Registry - ghcr.io/ra341/dockman
• Community Discussions

Apoya el canal GENBYTE

Suscríbete al canal de YouTube Suscríbete a la newsletter semanal Invítame a un Ko-fi genbyte@proton.me

Sígueme en mis redes sociales

Telegram Discord YouTube GitHub Blog Twitter