Saltar al contenido
Primeros pasos

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/…):

docker-compose.yml
services:
  web:
    volumes:
      - ./datos:/app/datos
      - /srv/fotos:/data/fotos:ro
      - /srv/compartido:/data/compartido

Aplica 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 ella

Si 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 tu docker-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 el docker-compose.yml:
docker-compose.override.yml
services:
  web:
    volumes:
      - /srv/fotos:/data/fotos:ro

Actualizar 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.