Unraid

O Immich pode ser facilmente instalado e atualizado no Unraid através de:

1. Plugin Docker Compose Manager dos Unraid Community Apps
2. Modelo criado pela comunidade no Unraid Community Apps

Modelo de Aplicativo da Comunidade

informação

• O modelo do Unraid utiliza uma imagem feita pela comunidade e não é oficialmente suportado pelo Immich

Para instalar o Immich a partir do Unraid CA, você precisará de um container de Redis e PostgreSQL 14 já existentes. Se você ainda não tiver Redis ou PostgreSQL, pode instalá-los a partir do Unraid CA, apenas certifique-se de escolher o PostgreSQL 14.

Depois de ter o Redis e PostgreSQL em execução, procure pelo Immich no Unraid CA, escolha um dos modelos listados e preencha as variáveis de exemplo.

Para mais informações sobre como configurar a imagem da comunidade, veja aqui

Método Docker-Compose (Oficial)

informação

• Este guia foi escrito usando o Unraid v6.12.10.
• Requer a instalação do plugin: Docker Compose Manager
• Um compartilhamento do Unraid criado para suas imagens
• Há um relato de que isso pode não funcionar se o servidor Unraid não suportar AVX (ex.: usando um T610)

Etapas de Instalação

1. Vá em "Plugins" e clique em "Compose.Manager"
2. Clique em "Add New Stack" e, quando solicitado, informe o rótulo "Immich"

3. Selecione o ícone de engrenagem ⚙️ ao lado de Immich e clique em "Edit Stack"
4. Clique em "Compose File" e, em seguida, cole todo o conteúdo do arquivo Immich Docker Compose no editor do Unraid. Remova qualquer texto que possa estar na área de texto por padrão. Observe que o Unraid v6.12.10 usa a versão 24.0.9 do Docker Engine, que não suporta o start_interval no healthcheck definido no serviço database do arquivo docker-compose (é necessária a versão 25 ou superior). Este parâmetro define um período inicial de espera antes de iniciar verificações de integridade, para dar tempo ao container de ser iniciado. Comentando os parâmetros start_interval e start_period, será possível iniciar normalmente os containers, mas o lado negativo será que o container do banco de dados não receberá uma verificação inicial de integridade até que o tempo do interval tenha se passado.

Usando um container PostgreSQL existente? Clique aqui! Caso contrário, avance para a etapa 5.

• Comente o serviço de banco de dados

• Comente a dependência do banco de dados para cada serviço (exemplo na captura de tela abaixo mostra apenas 2 serviços - certifique-se de fazer isso para todos os serviços)

• Comente os volumes

5. Clique em "Save Changes"; você será solicitado a editar os rótulos da interface do stack, apenas deixe em branco e clique em "Ok"

6. Selecione o ícone de engrenagem ⚙️ ao lado de Immich, clique em "Edit Stack" e depois clique em "Env File"

7. Cole todo o conteúdo do arquivo Immich example.env no editor do Unraid e antes de salvar, edite o seguinte:

   • UPLOAD_LOCATION: Crie uma pasta no compartilhamento de imagens do Unraid e insira o caminho absoluto aqui > Por exemplo, meu compartilhamento "images" contém uma pasta chamada "immich". Se eu acessar este diretório no terminal e digitar pwd, o resultado será /mnt/user/images/immich. Este é o valor exato que devo inserir como meu UPLOAD_LOCATION

   • DB_DATA_LOCATION: Altere este para usar um compartilhamento do Unraid (de preferência um cache pool, ex.: /mnt/user/appdata/postgresql/data). Este usa o compartilhamento appdata. Também crie a pasta postgresql executando mkdir /mnt/user/{share_location}/postgresql/data. Se mantido como padrão, ele tentará usar a pasta /boot/config/plugins/compose.manager/projects/[stack_name]/postgres do Unraid, para a qual não possui permissões, resultando no reinício contínuo do container.

     
   Usando um container PostgreSQL existente? Clique aqui! Caso contrário, avance para a etapa 8.

   Atualize as seguintes variáveis de banco de dados, conforme relevante para seu container PostgreSQL:

   • DB_HOSTNAME
   • DB_USERNAME
   • DB_PASSWORD
   • DB_DATABASE_NAME
   • DB_PORT

8. Clique em "Save Changes" seguido de "Compose Up" e o Unraid começará a criar os containers do Immich em uma janela pop-up. Quando concluído, você verá uma mensagem na janela informando "Connection Closed". Clique em "Done" e vá para a página "Docker" do Unraid

   Nota: Isso pode levar vários minutos dependendo da velocidade da Internet e do hardware do Unraid

9. Uma vez na página do Docker, você verá vários containers Immich; um deles será rotulado como immich_server e terá um mapeamento de portas. Acesse o IP:PORT mostrado no seu navegador e você verá a página de configuração do administrador do Immich.

Usando o plugin FolderView para organizar seus containers Docker? Clique aqui! Caso contrário, você concluiu!

Se você está usando o plugin FolderView, vá para a aba Docker e selecione "New Folder".
Rotule como "Immich" e use este URL como o logotipo: https://raw.githubusercontent.com/immich-app/immich/main/design/immich-logo.png
Então, selecione todos os containers relacionados ao Immich antes de clicar em "Submit"

dica

Para mais detalhes sobre como usar o aplicativo depois de instalado, consulte o guia Pós-Instalação.

Etapas de Atualização

perigo

Certifique-se de ler as instruções gerais de atualização.

A atualização é extremamente fácil, mas é importante estar ciente de que os containers gerenciados pelo plugin Docker Compose Manager não se integram à interface Dockerman nativa do Unraid; a etiqueta "pronto para atualização" sempre estará presente em containers instalados via Docker Compose Manager.

Você deve ignorar o "pronto para atualização" na WebUI do Unraid e atualizar quando receber a notificação dentro da WebUI do Immich.

1. Vá para a aba "Docker" e role para a seção Compose
2. Ao lado de Immich, clique no botão "Update Stack" e o Unraid começará a atualizar todos os containers relacionados ao Immich

   Nota: Não selecione Compose Down antes, isso é desnecessário.

3. Quando concluído, você verá uma mensagem "Connection Closed", selecione "Done".
4. Retorne à WebUI do Immich e você verá que a versão foi atualizada para a mais recente