Localizações Personalizadas de Arquivos
Este guia explica como armazenar arquivos gerados e brutos com o uso de montagem de volume do docker em diferentes locais.
É importante lembrar-se de atualizar as configurações de backup após seguir o guia para fazer backup dos novos caminhos de backup, caso esteja usando ferramentas de backup automáticas, especialmente profile/.
No nosso arquivo .env, definiremos os caminhos que queremos usar. Note que você não precisa definir todos eles: UPLOAD_LOCATION será a pasta base onde os arquivos são armazenados por padrão, com os outros caminhos atuando como substituições.
# Você pode encontrar a documentação para todas as variáveis de ambiente suportadas [aqui](/docs/install/environment-variables)
# Localização personalizada onde seus arquivos enviados, miniaturas e vídeos transcodificados são armazenados
- 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
...
Após definir os locais desses arquivos, editaremos o arquivo docker-compose.yml para adicionar as novas variáveis ao contêiner immich-server. Esses caminhos são onde os pontos de montagem se conectam dentro do contêiner, portanto, não os altere.
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
Depois de fazer essa alteração, você precisa mover os arquivos para as novas pastas para garantir que o Immich consiga encontrar tudo o que precisa. Se você não tiver carregado nada importante ainda, também pode reiniciar o Immich completamente, excluindo a pasta do banco de dados. Em seguida, reinicie o Immich para registrar as alterações:
docker compose up -d
Devido às propriedades subjacentes dos pontos de montagem do docker, não é recomendado montar as pastas upload/ e library/ como pontos de montagem separados se estiverem no mesmo dispositivo.
Por esse motivo, montamos o HDD ou o armazenamento em rede (NAS) em /usr/src/app/upload e, em seguida, montamos as pastas que queremos acessar dentro desse diretório.
A pasta thumbs/ contém tanto as miniaturas pequenas exibidas na linha do tempo quanto as pré-visualizações maiores mostradas ao clicar em uma imagem. Essas não podem ser separadas.
Os dados de métrica de armazenamento do servidor Immich rastrearão o armazenamento disponível em UPLOAD_LOCATION, portanto, o administrador deve configurar algum tipo de monitoramento para garantir que o armazenamento não fique sem espaço. A pasta profile/ é muito menor, geralmente menos de 1 MB.