Pasos generales de instalación:#

1. Descarga los archivos requeridos
   • Selecciona el lugar donde vivirá la aplicación. Por ejemplo:
     • /opt/immich
     • mkdir immich
   • Descarga docker-compose.yml
     • wget -O docker-compose.yml https://github.com/immich-app/immich/releases/latest/download/docker-compose.yml
   • Descarga .env
     • wget -O .env https://github.com/immich-app/immich/releases/latest/download/example.env
2. Ingresa los valores requeridos del archivo .env (Recuerda cambiar los datos por defecto)
   • UPLOAD_LOCATION=./library. En caso de Raspberry Pi, un disco duro externo
   • DB_DATA_LOCATION=./postgres
   • IMMICH_VERSION=release
   • DB_PASSWORD=postgres
   • DB_USERNAME=postgres
   • DB_DATABASE_NAME=immich
3. Start the containers
   • sudo docker compose up -d
4. Visitas la aplicación y completas el formulario
   • http://<machine-ip-address>:2283

Configuración en Docker compose#

1. Desde el lugar dónde instalaste tu immich detienes y eliminas los contenedores, redes y volúmenes definidos en tu archivo docker-compose.yml.

1
# Detenemos y eliminamos el contenedor actual
2
sudo docker compose down
3

4
# Editas el archivo docker-compose.yml
5
vim docker-compose.yml

2. Añades los volumenes a tu archivo de configuración
   • /mnt/your/location/:/mnt/custom/docker/location

Ejemplo:

1
immich-server:
2
    ...
3
    volumes:
4
      # Do not edit the next line. If you want to change the media storage location on your system, edit the value of UPLOAD_LOCATION in the .env file
5
      - ${UPLOAD_LOCATION}:/data
6
      - /etc/localtime:/etc/localtime:ro
7
      - /mnt/your/location:/mnt/custom/docker/location
8
      - /mnt/your/location/2:/mnt/custom/docker/location/2

3. Levantas nuevamente el contenedor

1
sudo docker compose up -d

Configuración en la aplicación#

Con la cuenta del administrador:

• Administration
• External Libraries Tab
• Create Library
• Edit import path

Referencias#

• Vídeo en Youtube
• Libraries/
• Eexternal library/

Creación de un respaldo#

1
DB_USERNAME=username_database
2
sudo docker exec -t immich_postgres pg_dumpall --clean --if-exists --username=$DB_USERNAME | gzip > "./backup_$(date '+%Y-%m-%d_%H%M%S').sql.gz"

Recuperación desde un respaldo#

1
# Borra el contenedor actual
2
sudo docker compose down -v
3

4
# Borra la ubicación de tu instalación de postgres para Immich
5
sudo rm -rf DB_DATA_LOCATION
6

7
# Opcional - Update to latest version of Immich (if desired)
8
# sudo docker compose pull
9

10
# Crea los contenedores de Docker sin ejecutarlos
11
sudo docker compose create
12

13
# Inicia el servidor de Postgres y espera 10 segundos a que inicie
14
sudo docker start immich_postgres && sleep 10
15

16
# Restaura los datos desde el Backup
17
PATH_BACKUP=/backup/location/dump_file.sql.gz
18
DB_NAME=db_name
19
DB_USERNAME=db_username
20

21
gunzip --stdout $PATH_BACKUP \
22
| sed "s/SELECT pg_catalog.set_config('search_path', '', false);/SELECT pg_catalog.set_config('search_path', 'public, pg_catalog', true);/g" \
23
| sudo docker exec -i immich_postgres psql --dbname=$DB_NAME --username=$DB_USERNAME
24

25
# Inicias de nuevo el contenedor
26
sudo docker compose up -d

Montado del disco#

1
# Lista los dispositivos de bloque
2
lsblk
3

4
# Desciframos la información contenida en el disco
5
sudo cryptsetup luksOpen /dev/sdXN fotos
6

7
sudo mount /dev/mapper/fotos /mnt/fotos

• X = Letra
• N = Número
• fotos = cualquier alias
• segundo /mnt/fotos = ubicación para montar

Desmontado del disco#

1
# Paramos nuestra instancia de immich (pues usa el disco)
2
sudo docker compose down
3

4
# Desmontado del disco y cifrado del mismo
5
sudo umount /mnt/fotos && sudo cryptsetup luksClose fotos

¿Cómo recuperar mi password?#

• server commands

1
# Entras al contenedor de forma interactiva
2
sudo docker exec -it immich_server bash
3

4
# Ejecutas la utilidad para recuperar el password del administrador
5
immich-admin reset-admin-password
6

7
# Sales del contenedor
8
exit

¿Cómo desinstalar immich?#

• how can i purge data from immich

1. Desde el lugar dónde instalaste tu immich detienes y eliminas los contenedores, redes y volúmenes definidos en tu archivo docker-compose.yml.

1
docker compose down -v

2. Borras todo lo relacionado a immich (se pueden consultar los valores en el archivo .env)

• DB_DATA_LOCATION contains the database, media info, and settings.
• UPLOAD_LOCATION contains all the media uploaded to Immich.