Carpetas locales
Publica carpetas del servidor o del NAS montándolas en el contenedor.
KumoYami corre dentro de un contenedor, así que solo ve las carpetas del equipo que le montes como volúmenes. Cada carpeta montada se publica después en el panel como un almacenamiento de tipo Carpeta local.
1. Monta la carpeta
En el docker-compose.yml, en volumes: del servicio web, añade una línea por carpeta: a la izquierda la ruta en el
equipo, a la derecha la ruta dentro del contenedor (usa /data/…):
services:
web:
volumes:
- ./datos:/app/datos
- /srv/fotos:/data/fotos:ro
- /srv/compartido:/data/compartidoAplica el cambio:
docker compose up -d:ro, solo lectura
Con :ro al final, KumoYami no puede modificar la carpeta: ni subir, ni renombrar, ni borrar. Úsalo en todo lo que
solo quieras mostrar. Sin :ro, lo que hagas en la web (subidas, buzones, mover, borrar) cambia los archivos reales.
2. Añádela en el panel
En el panel, Añadir almacenamiento → Carpeta local:
- Ruta en la web: dónde se verá, por ejemplo
/fotos(o/para la raíz). - Carpeta: la ruta dentro del contenedor, la de la derecha:
/data/fotos.
Permisos
El contenedor se ejecuta con el usuario de uid 1000. Para mostrar una carpeta, ese usuario debe poder leerla; para subir o borrar, también escribir. Si el listado sale vacío o da error de permisos, revisa el propietario:
ls -ln /srv/fotos # el tercer número es el uid del propietario
sudo chown -R 1000:1000 /srv/compartido # solo si quieres que KumoYami escriba en ellaSi usas el instalador
Al volver a ejecutar install.sh, el docker-compose.yml se sustituye por la última versión (la anterior se guarda
como docker-compose.yml.bak-FECHA) y tus volúmenes desaparecen de él. Tienes dos opciones:
- Volver a ejecutarlo con
--keep-compose, que conserva tudocker-compose.yml. - Si no usas el Caddy del instalador, poner los volúmenes en un
docker-compose.override.yml, que el instalador no toca. Docker Compose lo combina solo con eldocker-compose.yml:
services:
web:
volumes:
- /srv/fotos:/data/fotos:roActualizar con docker compose pull && docker compose up -d no cambia ningún archivo: tus volúmenes se quedan.
Opciones de cada carpeta
En el panel, cada almacenamiento tiene sus opciones: caché de listados (300 s por defecto; si añades archivos y no
aparecen, pulsa Refrescar), patrones para ocultar nombres (@eaDir, #recycle, *.tmp…), mostrar archivos
ocultos y calcular el tamaño de las carpetas. Las descargas de carpetas locales siempre pasan por el servidor.