diff --git a/docs/public/assets/screenshots/immichpg18/1.png b/docs/public/assets/screenshots/immichpg18/1.png new file mode 100644 index 0000000..8fce86f Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/1.png differ diff --git a/docs/public/assets/screenshots/immichpg18/10.png b/docs/public/assets/screenshots/immichpg18/10.png new file mode 100644 index 0000000..4dc32be Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/10.png differ diff --git a/docs/public/assets/screenshots/immichpg18/11.png b/docs/public/assets/screenshots/immichpg18/11.png new file mode 100644 index 0000000..1293c63 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/11.png differ diff --git a/docs/public/assets/screenshots/immichpg18/12.png b/docs/public/assets/screenshots/immichpg18/12.png new file mode 100644 index 0000000..6169a85 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/12.png differ diff --git a/docs/public/assets/screenshots/immichpg18/13.png b/docs/public/assets/screenshots/immichpg18/13.png new file mode 100644 index 0000000..7c0dc81 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/13.png differ diff --git a/docs/public/assets/screenshots/immichpg18/14.png b/docs/public/assets/screenshots/immichpg18/14.png new file mode 100644 index 0000000..f3a3938 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/14.png differ diff --git a/docs/public/assets/screenshots/immichpg18/15.png b/docs/public/assets/screenshots/immichpg18/15.png new file mode 100644 index 0000000..561294d Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/15.png differ diff --git a/docs/public/assets/screenshots/immichpg18/16.png b/docs/public/assets/screenshots/immichpg18/16.png new file mode 100644 index 0000000..1631405 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/16.png differ diff --git a/docs/public/assets/screenshots/immichpg18/17.png b/docs/public/assets/screenshots/immichpg18/17.png new file mode 100644 index 0000000..f2857d4 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/17.png differ diff --git a/docs/public/assets/screenshots/immichpg18/18.png b/docs/public/assets/screenshots/immichpg18/18.png new file mode 100644 index 0000000..c6a723e Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/18.png differ diff --git a/docs/public/assets/screenshots/immichpg18/19.png b/docs/public/assets/screenshots/immichpg18/19.png new file mode 100644 index 0000000..a5fa0b5 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/19.png differ diff --git a/docs/public/assets/screenshots/immichpg18/2.png b/docs/public/assets/screenshots/immichpg18/2.png new file mode 100644 index 0000000..b61bf79 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/2.png differ diff --git a/docs/public/assets/screenshots/immichpg18/20.png b/docs/public/assets/screenshots/immichpg18/20.png new file mode 100644 index 0000000..19a4243 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/20.png differ diff --git a/docs/public/assets/screenshots/immichpg18/3.png b/docs/public/assets/screenshots/immichpg18/3.png new file mode 100644 index 0000000..26287d6 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/3.png differ diff --git a/docs/public/assets/screenshots/immichpg18/4.png b/docs/public/assets/screenshots/immichpg18/4.png new file mode 100644 index 0000000..36269d5 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/4.png differ diff --git a/docs/public/assets/screenshots/immichpg18/5.png b/docs/public/assets/screenshots/immichpg18/5.png new file mode 100644 index 0000000..41309d0 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/5.png differ diff --git a/docs/public/assets/screenshots/immichpg18/6.png b/docs/public/assets/screenshots/immichpg18/6.png new file mode 100644 index 0000000..4242fe2 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/6.png differ diff --git a/docs/public/assets/screenshots/immichpg18/7.png b/docs/public/assets/screenshots/immichpg18/7.png new file mode 100644 index 0000000..0f2c26c Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/7.png differ diff --git a/docs/public/assets/screenshots/immichpg18/8.png b/docs/public/assets/screenshots/immichpg18/8.png new file mode 100644 index 0000000..e61a75b Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/8.png differ diff --git a/docs/public/assets/screenshots/immichpg18/9.png b/docs/public/assets/screenshots/immichpg18/9.png new file mode 100644 index 0000000..a794760 Binary files /dev/null and b/docs/public/assets/screenshots/immichpg18/9.png differ diff --git a/docs/troubleshooting/common-issues/ImmichPG18.md b/docs/troubleshooting/common-issues/ImmichPG18.md new file mode 100644 index 0000000..fdbd014 --- /dev/null +++ b/docs/troubleshooting/common-issues/ImmichPG18.md @@ -0,0 +1,135 @@ +# 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](https://deck.hexos.com) + 2) Navigate to the `settings` panel by selecting it on the left sidebar + ::: details Image + ![](../../public/assets/screenshots/immichpg18/1.png) + ::: + 3) Select the `TrueNAS` button + ::: details Image + ![](../../public/assets/screenshots/immichpg18/2.png) + ::: + 3) Select the new `TrueNAS` button + ::: details Image + ![](../../public/assets/screenshots/immichpg18/3.png) + ::: + 4) Login + - The username will be `truenas_admin` + - The password will be what you selected when first installing HexOS + ::: details Image + ![](../../public/assets/screenshots/immichpg18/4.png) + ::: + +## Updating Process + +1) Navigate to the `Apps` tab +::: details Image +![](../../public/assets/screenshots/immichpg18/5.png) +::: +2) Click on the Immich line +::: details Image +![](../../public/assets/screenshots/immichpg18/6.png) +::: +3) Stop Immich +::: details Image +![](../../public/assets/screenshots/immichpg18/7.png) +::: + +4) Determine Immich `version` on the `Application Info` card +> **Note:** Not to be confused with `App Version` +::: details Image +![](../../public/assets/screenshots/immichpg18/8.png) +::: +5) Modify the following command to include your Immich `Version` +``` +sudo nano /mnt/.ix-apps/app_configs/immich/versions//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` +::: details Image +![](../../public/assets/screenshots/immichpg18/9.png) +::: +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 +::: details Image +![](../../public/assets/screenshots/immichpg18/10.png) +::: +9) Use your arrow keys to scroll down to the `postgres_update_image` section +::: details Image +![](../../public/assets/screenshots/immichpg18/11.png) +::: +10) Change the `tag` to `1.1.11` +::: details Image +![](../../public/assets/screenshots/immichpg18/12.png) +::: +11) Save the changes + 1) Press `Control + X` to exit + ::: details Image + ![](../../public/assets/screenshots/immichpg18/13.png) + ::: + 2) Press `Y` to save + ::: details Image + ![](../../public/assets/screenshots/immichpg18/14.png) + ::: + 3) Press `Enter` to save the file name + ::: details Image + ![](../../public/assets/screenshots/immichpg18/15.png) + ::: +12) Return to the `Apps` tab +::: details Image +![](../../public/assets/screenshots/immichpg18/5.png) +::: +13) Click on the Immich line +::: details Image +![](../../public/assets/screenshots/immichpg18/16.png) +::: +14) On the `Application Info` card press `edit` +::: details Image +![](../../public/assets/screenshots/immichpg18/17.png) +::: +15) Edit the `Postgres Image (CAUTION)` line to `Postgres 18` +::: details Image +![](../../public/assets/screenshots/immichpg18/18.png) +::: +16) Scroll all the way down and press the `Update button` +17) Start the Immich app +::: details Image +![](../../public/assets/screenshots/immichpg18/19.png) +::: +> **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 +::: details Image +![](../../public/assets/screenshots/immichpg18/20.png) +::: +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](https://github.com/truenas/apps/issues/4628) to find a solution \ No newline at end of file diff --git a/docs/troubleshooting/common-issues/index.md b/docs/troubleshooting/common-issues/index.md index c591673..d8c5244 100644 --- a/docs/troubleshooting/common-issues/index.md +++ b/docs/troubleshooting/common-issues/index.md @@ -7,6 +7,7 @@ Having trouble with your HexOS setup? Check out these common issues and solution - [**Clear Browser Cache**](./ClearCache) - Fix login issues and UI problems by clearing your browser cache - [**Immich Migration**](./ImmichMigration) - Guide for migrating existing Immich installations to HexOS - [**Updating HexOS 24.10**](./UpgradingHexOS24.md) - Guide for updating HexOS 24.10 to HexOS 25.10 +- [**Updating Immich to Postgres 18**](./ImmichPG18.md) - Guide for updating Immich to Postgres 18 :::tip Contribute to Documentation Found a solution that worked? [Learn how to contribute](/community/how-to-contribute/) to improve these docs for everyone, submit corrections through the documentation repository, or share your solutions on the [HexOS Community Discord](https://discord.gg/fCW2htvYdz). diff --git a/docs/troubleshooting/index.md b/docs/troubleshooting/index.md index f190680..8439446 100644 --- a/docs/troubleshooting/index.md +++ b/docs/troubleshooting/index.md @@ -8,7 +8,8 @@ Check our [Common Issues](./common-issues/) section for frequently encountered p - [Immich Migration Guide](./common-issues/ImmichMigration) - Migrating existing Immich installations - [Clear Browser Cache](./common-issues/ClearCache) - Fixing login and UI issues - [Avoid USB Drives](./common-issues/AvoidUSBDrives) - Why USB drives cause problems -- [**Updating HexOS 24.10**](./common-issues/UpgradingHexOS24.md) - Guide for updating HexOS 24.10 to HexOS 25.10 +- [Updating HexOS 24.10](./common-issues/UpgradingHexOS24.md) - Guide for updating HexOS 24.10 to HexOS 25.10 +- [Updating Immich to Postgres 18](./common-issues/ImmichPG18.md) - Guide for updating Immich to Postgres 18 Visit the [HexOS Community](https://discord.gg/fCW2htvYdz) for additional support from other users. :::