Skip to content

migrate-immich.md

Latest commit

 

History

History
96 lines (85 loc) · 5.09 KB

migrate-immich.md

File metadata and controls

96 lines (85 loc) · 5.09 KB

Immich Migration

Who is this guide for?

  • Someone who followed the original @Serversathome guide to setting up Immich, and now wants to migrate to the new folder structure.

High level plan for migration:

  • Create the new dataset configuration /mnt/tank/configs/immich1 (i.e. do not touch the original dataset /mnt/tank/configs/immich)
  • Create the new sub-datasets data and db
  • Sync the data to the new dataset, using rsync immich -> immich1
  • Spin up Immich as a second instance, from TrueNAS Discover Apps (must have a unique name and port, as it will be running concurrently).
  • Once everything is confirmed working, then pull down the first instance & delete the original dataset.

Step 1 - Create new dataset

  • Create a new dataset /mnt/tank/configs/immich1 - Apps permissions.
    Note: you can call it what you like, but I will proceed with immich1

Step 2 - Create new sub-datasets

  • Create 2x datasets underneath
    • /mnt/tank/configs/immich1/data - Apps permissions
    • /mnt/tank/configs/immich1/db - Generic permissions
      Note: since these datasets are volume mounnts in Docker, you can also call them what you like.

Step 3 - rsync

The rsync commands will create the necessary sub-directories in the new datasets. These commands assume the original dataset names are {backups, library, profile, thumbs, video, uploads}. The required sub-directory names are: {backups, library, profile, thumbs, encoded-video, upload}.
IMPORTANT: As per the Immich depreciation notice, it is very imporant to follow these sub-directory naming conventions.

  • Run rsync to sync the datasets, with the following commands:
  1. rsync -avhz --progress /mnt/tank/configs/immich/backups/ /mnt/tank/configs/immich1/data/backups/
  2. rsync -avhz --progress /mnt/tank/configs/immich/library/ /mnt/tank/configs/immich1/data/library/
  3. rsync -avhz --progress /mnt/tank/configs/immich/profile/ /mnt/tank/configs/immich1/data/profile/
  4. rsync -avhz --progress /mnt/tank/configs/immich/thumbs/ /mnt/tank/configs/immich1/data/thumbs/
  5. rsync -avhz --progress /mnt/tank/configs/immich/video/ /mnt/tank/configs/immich1/data/encoded-video/ IMPORTANT the orginial guide used the dataset name video. It seems to be important to ensure the sync'ed folder is named encoded-video.
  6. rsync -avhz --progress /mnt/tank/configs/immich/uploads /mnt/tank/configs/immich1/data/upload IMPORTANT the orginial guide used the dataset name uploads. It seems to be important to ensure this folder is named upload.
  • Run rsync to sync the database:
  1. rsync -avhz --progress /mnt/tank/configs/immich/db/ /mnt/tank/configs/immich1/db/

Instead of running each individually, this will run sequentially but stop if any command fails to run. i.e. This runs the next command only if the previous one succeeds:

rsync -avhz --progress /mnt/tank/configs/immich/backups/ /mnt/tank/configs/immich1/data/backups/ && \
rsync -avhz --progress /mnt/tank/configs/immich/library/ /mnt/tank/configs/immich1/data/library/ && \
rsync -avhz --progress /mnt/tank/configs/immich/profile/ /mnt/tank/configs/immich1/data/profile/ && \
rsync -avhz --progress /mnt/tank/configs/immich/thumbs/ /mnt/tank/configs/immich1/data/thumbs/ && \
rsync -avhz --progress /mnt/tank/configs/immich/video/ /mnt/tank/configs/immich1/data/encoded-video/ && \
rsync -avhz --progress /mnt/tank/configs/immich/uploads/ /mnt/tank/configs/immich1/data/upload/ && \
rsync -avhz --progress /mnt/tank/configs/immich/db/ /mnt/tank/configs/immich1/db/

Step 3 - Confirm data synced correctly

  • cd /mnt/tank/configs/immich1/data/thumbs
  • ls -l
  • cd /mnt/tank/configs/immich1/backups
  • ls -l
  • cd /mnt/tank/configs/immich1/db
  • ls -l, etc.. etc..

Step 4 - note the existing install config

  • Grab the Database Password: from the truenas app configuration page (I don't know if this is essential - but didn't want to risk it)
  • Grab the Redis Password: from the truenas app configuration page (I don't know if this is essential - but didn't want to risk it)

Step 5 - Install Immich (again!)

  • On TrueNAS:
  • Apps > Discover Apps
  • Search: "Immich"
  • Click Install Another Instance

Step 6 - Configure the New Instance

Application name

  • Application name: immich1
  • Version: 1.9.103

Immich Configuration

  • Enable Machine Learning: checked
  • Machine Learning Image Type: Default Machine Learning Image
  • Log Level: Verbose
  • Database storage type: HDD

User and Group Configuration

  • UserID: 568
  • GroupID: 568

Network Configuration

  • Port Number: 30042 (Ensure this is unique - original install was 30041)

Storage Configuration

  • Use Old Storage Configuration (Deprecated): Unchecked
  • Data Storage (aka Upload Location):
    • Type: Host path
    • Enable ACL: unchecked
    • Host Path: /mnt/tank/configs/immich1/data
  • Machine Learning Cache: Temporary
  • Postgres Data Storage:
    • Type: Host path
    • Enable ACL: unchecked
    • Host Path: /mnt/tank/configs/immich1/db
    • Automatic permissions: checked

Resources Configuration

  • CPUs: 4
  • Memory (in MB): 8000

Step 7 - Click install

Click install