merging immich updating to postgres 18 guide

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/<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`
+::: 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

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).

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.
 :::