Saltar al contenido principal

Ubicaciones personalizadas de archivos

Esta guía explica cómo almacenar archivos generados y crudos con el montaje de volumen de docker en diferentes ubicaciones.

Copia de seguridad

Es importante recordar actualizar la configuración de copia de seguridad después de seguir la guía para incluir las nuevas rutas de copia de seguridad si se utilizan herramientas de copia automática, especialmente profile/.

En nuestro archivo .env, definiremos las rutas que queremos utilizar. Tenga en cuenta que no es necesario definir todas ellas: UPLOAD_LOCATION será la carpeta base en la que se almacenan los archivos por defecto, mientras que las otras rutas actúan como excepciones.

.env
# Puede encontrar documentación para todas las variables de entorno soportadas [aquí](/docs/install/environment-variables)

# Ubicación personalizada donde se almacenan sus archivos cargados, miniaturas y videos transcodificados
- UPLOAD_LOCATION=./library
+ UPLOAD_LOCATION=/custom/path/immich/immich_files
+ THUMB_LOCATION=/custom/path/immich/thumbs
+ ENCODED_VIDEO_LOCATION=/custom/path/immich/encoded-video
+ PROFILE_LOCATION=/custom/path/immich/profile
+ BACKUP_LOCATION=/custom/path/immich/backups
...

Después de definir las ubicaciones de estos archivos, editaremos el archivo docker-compose.yml en consecuencia y agregaremos las nuevas variables al contenedor immich-server. Estas rutas son los puntos de montaje dentro del contenedor, por lo que no debe cambiarlas.

docker-compose.yml
services:
immich-server:
volumes:
- ${UPLOAD_LOCATION}:/usr/src/app/upload
+ - ${THUMB_LOCATION}:/usr/src/app/upload/thumbs
+ - ${ENCODED_VIDEO_LOCATION}:/usr/src/app/upload/encoded-video
+ - ${PROFILE_LOCATION}:/usr/src/app/upload/profile
+ - ${BACKUP_LOCATION}:/usr/src/app/upload/backups
- /etc/localtime:/etc/localtime:ro

Después de realizar este cambio, debe mover los archivos a las nuevas carpetas para asegurarse de que Immich pueda encontrar todo lo que necesita. Si aún no ha cargado nada importante, también puede reiniciar Immich completamente eliminando la carpeta de base de datos. Luego reinicie Immich para registrar los cambios:

docker compose up -d
nota

Por las propiedades subyacentes de los montajes vinculados de docker, no se recomienda montar las carpetas upload/ y library/ como montajes vinculados separados si están en el mismo dispositivo. Por esta razón, montamos el HDD o el almacenamiento en red (NAS) en /usr/src/app/upload y luego montamos las carpetas que queremos acceder dentro de esa carpeta.

La carpeta thumbs/ contiene tanto las miniaturas pequeñas que se muestran en la línea de tiempo como las vistas previas más grandes que se muestran al hacer clic en una imagen. Estas no se pueden separar.

Las métricas de almacenamiento del servidor Immich rastrearán el almacenamiento disponible en UPLOAD_LOCATION, por lo que el administrador debe configurar algún tipo de monitoreo para asegurarse de que el almacenamiento no se quede sin espacio. La carpeta profile/ es mucho más pequeña, generalmente menos de 1 MB.