Updating Immich to use Postgres 18

Overview

• This guide applies to users unable to update Immich and getting the following error [EINVAL] immich.postgres_image_selector: Input should be 'vectorchord_18_image'
• This guide only applies to users that are still able to access the Immich WebUI

Logging into the TrueNAS WebUI

• Log into TrueNAS UI
  1. Navigate to HexOS Deck
  2. Navigate to the settings panel by selecting it on the left sidebar
  Image

  

  3. Select the TrueNAS button
  Image

  

  3. Select the new TrueNAS button
  Image

  

  4. Login
     • The username will be truenas_admin
     • The password will be what you selected when first installing HexOS
     Image

     

Updating Process

1. Navigate to the Apps tab

Image

2. Click on the Immich line

Image

3. Stop Immich

Image

4. Determine Immich version on the Application Info card

Note: Not to be confused with App Version

Image

5. Modify the following command to include your Immich Version

sudo nano /mnt/.ix-apps/app_configs/immich/versions/<insert_your_immich_version>/ix_values.yaml

In this example the command would be

sudo nano /mnt/.ix-apps/app_configs/immich/versions/1.14.13/ix_values.yaml

6. Navigate to the System tab and then select shell

Image

7. Paste the command created in step 4 and press enter

Note: To paste things in shell you need to press Shift + Enter

8. You will be asked to enter your password.
   • This is the same password used to login into TrueNAS
   • There will be no input shown on screen as a security feature
   • When you finish entering your password you can press enter

Image

9. Use your arrow keys to scroll down to the postgres_update_image section

Image

10. Change the tag to 1.1.11

Image

11. Save the changes
    1. Press Control + X to exit
    Image

    

    2. Press Y to save
    Image

    

    3. Press Enter to save the file name
    Image

    

12. Return to the Apps tab

Image

13. Click on the Immich line

Image

14. On the Application Info card press edit

Image

15. Edit the Postgres Image (CAUTION) line to Postgres 18

Image

16. Scroll all the way down and press the Update button
17. Start the Immich app

Image

Note: Starting Immich will take longer than usual this time.

18. Once Immich has the Running status open the WebUI and make sure Immich is functioning normally

Image

19. Update the Immich app in HexOS

If you still can't update Immich

If you are still having trouble updating Immich please reach out to support@hexos.com

Community credits

sunny_raven - Created the original guide in the HexOS forums

BruteNas - Provided the instructions to saving files in shell

Also a big thank you to everyone that contributed on github to find a solution