Portainer/dozzle/README.md

Dozzle

Stack para desplegar Dozzle como visor ligero de logs Docker en dozzle.sherlockhomeless.net.

🚀 Despliegue en Portainer

1. Ve a Stacks → Add stack
2. Nombre: dozzle
3. Selecciona Repository o Git repository
4. Configura:
   • Repository URL: <tu-repositorio>
   • Repository reference: main
   • Compose path: dozzle/docker-compose.yml
5. Copia dozzle/stack.env a dozzle/.env y carga dozzle/.env como archivo de variables de entorno
6. Haz clic en Deploy the stack

⚙️ Variables importantes

Edita dozzle/.env:

DOZZLE_DOMAIN=dozzle.sherlockhomeless.net
DOZZLE_DATA_PATH=/opt/dozzle/data
TRAEFIK_AUTH_MIDDLEWARE=ths-authentik@docker
DOZZLE_ENABLE_ACTIONS=false
DOZZLE_ENABLE_SHELL=false

📁 Preparación del host

Crea el directorio persistente antes del primer arranque:

mkdir -p /opt/dozzle/data

🔐 Autenticación y acceso

Dozzle no trae autenticación suficiente para exponerse tal cual a Internet, así que este stack lo publica detrás de Traefik y fuerza el middleware compartido ths-authentik@docker.

La autenticación se resuelve por completo en Traefik + Authentik antes de llegar al contenedor. Dozzle no expone puertos directos al host, así que no queda accesible sin pasar por ese middleware. Se mantienen desactivadas las acciones y el acceso shell para no dar más privilegios de los necesarios sobre docker.sock.

🏠 Integración con Homepage

El servicio publica labels homepage.*, así que puede aparecer automáticamente en Homepage dentro del grupo Observabilidad como enlace al dominio configurado. Homepage no dispone de un widget nativo para Dozzle, así que aquí solo se expone la tarjeta del servicio.