diff --git a/docs/.vitepress/sidebar.ts b/docs/.vitepress/sidebar.ts
index c063fe30..276e2d06 100644
--- a/docs/.vitepress/sidebar.ts
+++ b/docs/.vitepress/sidebar.ts
@@ -65,8 +65,17 @@ const sidebar: DefaultTheme.SidebarItem[] = [
collapsed: true,
items: [
{ text: 'Overview', link: '/troubleshooting/' },
- { text: 'Avoid USB Drives', link: '/troubleshooting/common-issues/AvoidUSBDrives' },
- { text: 'Clear Browser Cache', link: '/troubleshooting/common-issues/ClearCache' },
+ {
+ text: 'Common Issues',
+ link: '/troubleshooting/common-issues/',
+ collapsed: true,
+ items: [
+ { text: 'Application Errors', link: '/troubleshooting/common-issues/ApplicationErrors' },
+ { text: 'Avoid USB Drives', link: '/troubleshooting/common-issues/AvoidUSBDrives' },
+ { text: 'Clear Browser Cache', link: '/troubleshooting/common-issues/ClearCache' },
+ { text: 'Immich Migration', link: '/troubleshooting/common-issues/ImmichMigration' },
+ ]
+ },
]
},
{
@@ -139,6 +148,7 @@ const sidebar: DefaultTheme.SidebarItem[] = [
collapsed: true,
items: [
// auto-generated-release-notes-start
+ { text: '2026-01-21', link: '/release-notes/command-deck/2026-01-21' },
{ text: '2026-01-13', link: '/release-notes/command-deck/2026-01-13' },
{ text: '2026-01-08', link: '/release-notes/command-deck/2026-01-08' },
{ text: '2025-12-30', link: '/release-notes/command-deck/2025-12-30' },
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-0.png b/docs/public/assets/screenshots/Immich-migration-tmux-0.png
new file mode 100644
index 00000000..d1a72232
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-0.png differ
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-1.png b/docs/public/assets/screenshots/Immich-migration-tmux-1.png
new file mode 100644
index 00000000..3cc2fdab
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-1.png differ
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-10.png b/docs/public/assets/screenshots/Immich-migration-tmux-10.png
new file mode 100644
index 00000000..7e7bb9f1
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-10.png differ
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-11.png b/docs/public/assets/screenshots/Immich-migration-tmux-11.png
new file mode 100644
index 00000000..364a6d9a
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-11.png differ
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-2.png b/docs/public/assets/screenshots/Immich-migration-tmux-2.png
new file mode 100644
index 00000000..d9024168
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-2.png differ
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-3.png b/docs/public/assets/screenshots/Immich-migration-tmux-3.png
new file mode 100644
index 00000000..3c1f933d
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-3.png differ
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-4.png b/docs/public/assets/screenshots/Immich-migration-tmux-4.png
new file mode 100644
index 00000000..3fd74114
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-4.png differ
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-5.png b/docs/public/assets/screenshots/Immich-migration-tmux-5.png
new file mode 100644
index 00000000..7e78fd9a
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-5.png differ
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-6.png b/docs/public/assets/screenshots/Immich-migration-tmux-6.png
new file mode 100644
index 00000000..19e319ce
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-6.png differ
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-7.png b/docs/public/assets/screenshots/Immich-migration-tmux-7.png
new file mode 100644
index 00000000..7f65ac12
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-7.png differ
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-8.png b/docs/public/assets/screenshots/Immich-migration-tmux-8.png
new file mode 100644
index 00000000..d7718075
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-8.png differ
diff --git a/docs/public/assets/screenshots/Immich-migration-tmux-9.png b/docs/public/assets/screenshots/Immich-migration-tmux-9.png
new file mode 100644
index 00000000..441a3ca7
Binary files /dev/null and b/docs/public/assets/screenshots/Immich-migration-tmux-9.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/1.png b/docs/public/assets/screenshots/app-troubleshooting-guide/1.png
new file mode 100644
index 00000000..e6b5f311
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/1.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/10.png b/docs/public/assets/screenshots/app-troubleshooting-guide/10.png
new file mode 100644
index 00000000..2d7ff54b
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/10.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/11.png b/docs/public/assets/screenshots/app-troubleshooting-guide/11.png
new file mode 100644
index 00000000..c5ee1cf8
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/11.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/12.png b/docs/public/assets/screenshots/app-troubleshooting-guide/12.png
new file mode 100644
index 00000000..8ca427da
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/12.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/13.png b/docs/public/assets/screenshots/app-troubleshooting-guide/13.png
new file mode 100644
index 00000000..e88e1e65
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/13.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/14.png b/docs/public/assets/screenshots/app-troubleshooting-guide/14.png
new file mode 100644
index 00000000..554838f5
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/14.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/15.png b/docs/public/assets/screenshots/app-troubleshooting-guide/15.png
new file mode 100644
index 00000000..55ca766c
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/15.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/16.png b/docs/public/assets/screenshots/app-troubleshooting-guide/16.png
new file mode 100644
index 00000000..058a6e9d
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/16.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/17.png b/docs/public/assets/screenshots/app-troubleshooting-guide/17.png
new file mode 100644
index 00000000..ac82ff24
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/17.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/18.png b/docs/public/assets/screenshots/app-troubleshooting-guide/18.png
new file mode 100644
index 00000000..c24e2857
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/18.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/19.png b/docs/public/assets/screenshots/app-troubleshooting-guide/19.png
new file mode 100644
index 00000000..c34a77c4
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/19.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/2.png b/docs/public/assets/screenshots/app-troubleshooting-guide/2.png
new file mode 100644
index 00000000..36269d59
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/2.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/20.png b/docs/public/assets/screenshots/app-troubleshooting-guide/20.png
new file mode 100644
index 00000000..6f46ac7b
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/20.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/3.png b/docs/public/assets/screenshots/app-troubleshooting-guide/3.png
new file mode 100644
index 00000000..58ec3ebf
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/3.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/4.png b/docs/public/assets/screenshots/app-troubleshooting-guide/4.png
new file mode 100644
index 00000000..33189f33
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/4.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/5.png b/docs/public/assets/screenshots/app-troubleshooting-guide/5.png
new file mode 100644
index 00000000..41604158
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/5.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/6.png b/docs/public/assets/screenshots/app-troubleshooting-guide/6.png
new file mode 100644
index 00000000..5dfcac90
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/6.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/7.png b/docs/public/assets/screenshots/app-troubleshooting-guide/7.png
new file mode 100644
index 00000000..50185cb3
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/7.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/8.png b/docs/public/assets/screenshots/app-troubleshooting-guide/8.png
new file mode 100644
index 00000000..0209a295
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/8.png differ
diff --git a/docs/public/assets/screenshots/app-troubleshooting-guide/9.png b/docs/public/assets/screenshots/app-troubleshooting-guide/9.png
new file mode 100644
index 00000000..89e8efb2
Binary files /dev/null and b/docs/public/assets/screenshots/app-troubleshooting-guide/9.png differ
diff --git a/docs/release-notes/command-deck/2026-01-21.md b/docs/release-notes/command-deck/2026-01-21.md
new file mode 100644
index 00000000..5b9cb323
--- /dev/null
+++ b/docs/release-notes/command-deck/2026-01-21.md
@@ -0,0 +1,27 @@
+# January 21, 2026 - Mobile Dialogs, App Lifecycle, Polish, HexOS Local Prep
+
+This release introduces improved app lifecycle management, mobile-optimized dialogs, and lays the groundwork for HexOS Local.
+
+## Enhancements
+
+### App Lifecycle Management
+
+App start and stop operations are now individually orchestrated, providing better progress tracking and improved update workflows. App cards display server messages directly from TrueNAS, surfacing any startup configuration issues or lifecycle problems immediately for faster troubleshooting.
+
+### Mobile-Optimized Dialogs
+
+We're testing a new dialog on mobile to give better accessibility and reach. These appear as traditional modals on desktop and slide-up drawers on mobile. These have been applied to folders, users, and network settings.
+
+### Interface Polish
+
+We've refined the header styling and various UI elements throughout the interface. This includes improved input field borders and focus states, consistent button styling across dialogs, better light/dark mode transitions for dialog titles, and fixed button sizing inconsistencies.
+
+### HexOS Local Preparation
+
+This release also pushes a large block of code behind the scenes that will support the coming soon [HexOS Local](https://docs.hexos.com/blog/2025-11-25.html)
+
+### Additional Guides
+
+We've expanded our troubleshooting section with more guides for common issues. Check out the [latest here](/troubleshooting/common-issues/).
+
+**NOTE:** This update was applied automatically to your Command Deck. You may need to clear your cache. Help with clearing your cache is available [here](/troubleshooting/common-issues/ClearCache).
diff --git a/docs/release-notes/command-deck/index.md b/docs/release-notes/command-deck/index.md
index 7b952adb..289fb2f9 100644
--- a/docs/release-notes/command-deck/index.md
+++ b/docs/release-notes/command-deck/index.md
@@ -11,6 +11,7 @@ For users who are actively connected during an update, there may be a brief down
## 2026 Releases
+- [**2026-01-21**](./2026-01-21) - Mobile Dialogs, App Lifecycle, Polish, HexOS Local Prep
- [**2026-01-13**](./2026-01-13) - UI Improvements & Goldeye System Updates
- [**2026-01-08**](./2026-01-08) - HexOS Curated Apps & Enhanced Diagnostics
diff --git a/docs/troubleshooting/common-issues/ApplicationErrors.md b/docs/troubleshooting/common-issues/ApplicationErrors.md
new file mode 100644
index 00000000..9130f65f
--- /dev/null
+++ b/docs/troubleshooting/common-issues/ApplicationErrors.md
@@ -0,0 +1,218 @@
+# Application Troubleshooting Guide
+
+## Installation
+
+- If installation fails once, try again immediately
+- If it still fails check error
+ - This can be done by pressing the bell icon at the top of HexOS deck
+ - If HexOS shows an unknown error you can find more details by entering TrueNAS and selecting the clipboard icon
+::: details How to view the error in TrueNAS
+1) Login to [HexOS Deck Settings](https://deck.hexos.com/settings)
+2) Select the TrueNAS Button
+
+3) Login to TrueNAS
+ - Username: truenas_admin
+ - Password: What was selected when installing HexOS
+
+4) Click on the clipboard icon at the top of the screen
+
+:::
+
+## Updating
+
+An App has to be running for it to updated.
+It is good practice to update apps regularly.
+
+::: details How to update
+
+1) Open the [HexOS Deck applications](Https://deck.hexos.com/applications) section
+2) Select your app
+3) Select the Update button on the Application info card
+
+:::
+### If an app is not working after an application update
+
+If your app stopped working immediately after an update you can go into TrueNAS and roll back a previous version of your app.
+> Note: Some applications may have bugs when rolled back
+::: details Instructions for rolling back an application
+
+1) Login to [HexOS Deck Settings](https://deck.hexos.com/settings)
+
+2) Select the TrueNAS Button
+3) Login to TrueNAS
+ - Username: truenas_admin
+ - Password: What was selected when installing HexOS
+
+4) Navigate to the `Apps` tab on the left sidebar menu
+
+5) Click on your application
+6) Select the `Rollback` option on the `Application Info` card
+
+7) Select the most recent version of the app that worked and rollback
+
+:::
+
+## Resetting App Curation
+
+If the settings on an app were changed in TrueNAS you can use `Reset App Curation` to bring it back to the HexOS default configuration.
+> Note: This can be used to update your application settings if HexOS has updated the curation.
+::: details How to Reset App Curation
+1) Open [Hexos Deck Application](https://deck.hexos.com/application) section
+2) Select the app
+3) Select the `options` button on the application info card
+
+4) Select `Reset App Curation`
+
+:::
+
+
+## Application not showing up with the bookmarked link
+
+- Open directly from HexOS Deck
+- Check if your server's IP address has been updated
+
+## App not starting
+
+If apps are not starting after recent hardware changes you can try the following
+Motherboard changed: Try opening the app from HexOS Deck as your sever IP Address may have changed
+GPU changed: Try disabling GPU pass-through and disable using a gpu in the application configuration to troubleshoot
+::: details How to turn off GPU pass-through
+1) Select the app in HexOS deck
+2) Press the `options` button on the applications info card
+
+3) Press `Configure in TrueNAS`
+
+4) Scroll all the way to the bottom and uncheck GPU related options
+
+5) Press the Update button
+
+:::
+
+# App Specific Troubleshooting
+
+::: details Immich
+## Immich
+
+> Warning: Do Not uninstall immich as a troubleshooting step unless explicitly instructed to or are planning to start again fresh
+
+### Installation
+
+If you uninstalled Immich and it is no longer re-installing
+consider deleting the the old datasets and start over fresh
+> Warning: Deleting the old data sets will also delete the copy of your media on the server
+
+### Updating Immich
+
+#### Firmware 1.135.0 and higher
+
+Coming soon
+
+#### Firmware below 1.135.0
+
+Coming soon
+
+### Mobile Application not functioning
+
+Update the Immich app on both the server side and the mobile side
+
+### Immich Media not showing up
+
+Check the storage paths in the settings
+Uploads: (HDDs/SSDs)/Photos/immich
+Postgres: (HDDs/SSDs)/Applications/immich/postgres_data
+
+
+If your storage locations do not match and you installed Immich via HexOS, are on Immich version 2.0.0+ and have not modified Immich in TrueNAS then you can [`Reset App Curation`](/troubleshooting/common-issues/ApplicationErrors.html#resetting-app-curation)
+
+:::
+# What to do if you need more help with apps
+
+Fill out the following template and share it in on [HexOS HUB](https://hub.hexos.com) or contact us at Support@hexos.com
+
+## Template
+
+TrueNAS Version:
+Application Version:
+Model of CPU:
+Model of GPU:
+Modifications made in TrueNAS:
+Description of problem:
+Troubleshooting steps attempted:
+
+::: details TrueNAS Version
+
+TrueNAS Version can be found by
+1) Login to [HexOS Deck Settings](https://deck.hexos.com/settings)
+2) Select the TrueNAS Button
+
+3) Login to TrueNAS
+ - Username: truenas_admin
+ - Password: What was selected when installing HexOS
+
+4) On the system information card you will see your TrueNAS Version
+
+
+:::
+::: details Application Version
+
+The application Version can be found by
+1) Login to [HexOS Deck Settings](https://deck.hexos.com/settings)
+2) Select the TrueNAS Button
+
+3) Login to TrueNAS
+ - Username: truenas_admin
+ - Password: What was selected when installing HexOS
+
+4) Navigate to the `Apps` tab on the left sidebar menu
+5) Click on your application
+6) On the `Application Info` card you will see an `App Version`
+
+:::
+
+::: details Model of CPU
+
+The model of the CPU in your server can be found by
+1) Login to [HexOS Deck Settings](https://deck.hexos.com/settings)
+2) Select the TrueNAS Button
+
+3) Login to TrueNAS
+ - Username: truenas_admin
+ - Password: What was selected when installing HexOS
+
+4) On the `CPU Model` card you will see your CPU Model
+:::
+
+::: details Model of GPU
+1) Login to [HexOS Deck Settings](https://deck.hexos.com/settings)
+2) Select the TrueNAS Button
+
+3) Login to TrueNAS
+ - Username: truenas_admin
+ - Password: What was selected when installing HexOS
+
+4) Navigate to the `System` tab on the left sidebar menu
+
+5) Select `Shell`
+
+6) Type `lspci | egrep -i 'vga|3d|display'`
+
+:::
+::: details Modifications made in TrueNAS
+
+Example modifications
+- App installed via TrueNAS not HexOS
+- Storage pool created in TrueNAS not HexOS
+- App configuration modified in TrueNAS
+:::
+::: details Description of the problem
+
+Describe the problem
+When did it start?
+What steps did you take before the problem started?
+
+Include any errors reports that HexOS or TrueNAS informs you of in this section.
+:::
+::: details Troubleshooting steps attempted
+
+A brief overview of any steps you have tried.
+:::
diff --git a/docs/troubleshooting/common-issues/ImmichMigration.md b/docs/troubleshooting/common-issues/ImmichMigration.md
new file mode 100644
index 00000000..926598b7
--- /dev/null
+++ b/docs/troubleshooting/common-issues/ImmichMigration.md
@@ -0,0 +1,119 @@
+# Migrating Immich to New Storage Configuration
+
+## Prerequisites
+
+- This guide requires at least enough storage space free on a pool to create another copy of your current immich installation including media such as photos and videos.
+- This guide only applies to
+ - curated immich installations that have not been customized
+ - users that can still access the immich web-ui
+ - users with immich Version `v1.135.0` and higher
+ 1) Select `Apps` on the left side bar
+ 2) Click on the `immich` app on the list (Not the Checkbox)
+ 3) View the `Application Version` in the Application info card
+
+
+## Preparation
+- Note the contents of the `Photos` folder
+ - This can be done by viewing the `Photos` folder via SMB shares.
+ - [Instructions for how to access folder contents can be found here](/features/folders/how-to-access-folder-contents.html)
+- Stop the `immich` application
+- 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
+ 3) Select the TrueNAS button
+ 4) Login
+ - The username will be `truenas_admin`
+ - The password will be what you selected when first installing HexOS
+
+## Creating Datasets
+
+Once in the TrueNAS interface we will
+1) Select `Datasets` in the left sidebar
+
+2) Click on the pool with your `Photos` folder and press `Add Dataset`
+
+3) Name the Dataset `Photos2` and select `save`
+
+4) Click on the original `Photos` dataset and then press `Add Dataset`
+5) Name the Dataset `immich`, set the Dataset Preset to `Apps` and then select `save`
+
+
+## Copying Files
+
+1) Select `System` in the left sidebar
+2) Select `Shell` in the new sidebar
+
+3) Type `tmux` into the shell and press enter
+ - This creates a session of the terminal that will keep going even if the TrueNAS web-ui times out
+ - If the TrueNAS web-ui times out you can return to `shell` and type `tmux attach` to renter the session
+4) Input the following commands in sequential order
+ - There will be a prompt for the admin password
+ - When you enter the admin password the screen will not show any characters as a security feature
+ - When the password is fully inputted the command will run after pressing `enter`
+> **Note:** The following commands are for users that have their Photos and Applications on HDDs
+
+> **Note:** When accessing shell from a Windows computer, the paste command is changed to `Shift + Insert`
+
+```
+ sudo rsync -avh --stats --progress /mnt/HDDs/Photos/ /mnt/HDDs/Photos2/
+```
+```
+ sudo rsync -avh --stats --progress /mnt/.ix-apps/app_mounts/immich/backups/ /mnt/HDDs/Photos/immich/backups/
+```
+```
+ sudo rsync -avh --stats --progress /mnt/HDDs/Applications/immich/profile/ /mnt/HDDs/Photos/immich/profile/
+```
+```
+ sudo rsync -avh --stats --progress /mnt/HDDs/Applications/immich/thumbs/ /mnt/HDDs/Photos/immich/thumbs/
+```
+```
+ sudo rsync -avh --stats --progress /mnt/HDDs/Applications/immich/encoded_videos/ /mnt/HDDs/Photos/immich/encoded-video/
+```
+```
+ sudo rsync -avh --stats --progress /mnt/HDDs/Applications/immich/uploads/ /mnt/HDDs/Photos/immich/upload/
+```
+```
+ sudo rsync -avh --stats --progress /mnt/HDDs/Photos2/ /mnt/HDDs/Photos/immich/library/
+```
+
+## Updating Immich
+
+1) Select `Apps` in the left sidebar
+
+2) Select `immich`
+3) Verify `immich` app version is **1.132.0 or higher** in the application information card again
+4) Select `Edit` in the application information card
+
+5) Scroll down to the storage section
+6) Uncheck `Use old storage configuration`
+
+7) Select `Host Path` for Data Storage (aka Upload Location)
+8) Set the Host path to `/mnt/HDDs/Photos/immich`
+
+9) Scroll down to the bottom and select the update button
+10) Verify if the immich web-ui is working
+11) If immich Web-UI is working as expected, update the immich app in [HexOS Deck](https://deck.hexos.com)
+12) Verify if the immich web-ui is working and shows the most up to date version of immich
+
+## Cleaning up
+
+1) Stop the immich application
+2) we will be deleting the old datasets to free up storage space (Optional)
+ 1) Select `Datasets` in the left sidebar
+ 2) Click on the `Photos2` data set created earlier, press the `clipboard` to copy and press `Delete`
+ 
+ 3) Follow the on-screen prompts to confirm deletion
+ 
+ 4) Navigate to the ~/Applications/immich/ dataset
+ 5) Delete the `Backups`, `encoded-video`, `profile`, `thumbs` & `upload` datasets.
+> **Warning**: Do not delete the `postgres_data` dataset in the ~/Applications/immich/ dataset
+3) Open the original `Photos` folder using SMB again.
+ 1) Refer to the contents noted in the preparation section of this guide
+ 2) Make your hidden files visible
+ - Mac: In the Finder app while in the `Photos` folder and then press `Command + Shift + Period` to toggle hidden files.
+ - Windows: [Refer to these instructions](https://support.microsoft.com/en-us/windows/file-explorer-in-windows-ef370130-1cca-9dc5-e0df-2f7416fe1cb1#windowsversion=windows_11)
+ 3) Delete all files & folders **other than** the `immich` folder and any files & folders you added to the `Photos`folder
+4) Re-enter shell
+5) Type `tmux kill-server` and press enter
+6) Verify the tmux session has ended by entering `tmux attach`
+7) Restart the immich application and verify if the web-ui is working.
diff --git a/docs/troubleshooting/common-issues/index.md b/docs/troubleshooting/common-issues/index.md
index a8b42be9..1009388c 100644
--- a/docs/troubleshooting/common-issues/index.md
+++ b/docs/troubleshooting/common-issues/index.md
@@ -2,8 +2,10 @@
Having trouble with your HexOS setup? Check out these common issues and solutions from the community.
+- [**Application Errors**](./ApplicationErrors) - Troubleshooting app installation, updates, and startup issues
- [**Avoid USB Drives**](./AvoidUSBDrives) - Why USB drives can cause issues and what to use instead
- [**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
:::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 forum](https://hub.hexos.com/).
diff --git a/docs/troubleshooting/index.md b/docs/troubleshooting/index.md
index f43065db..ffc6a6f5 100644
--- a/docs/troubleshooting/index.md
+++ b/docs/troubleshooting/index.md
@@ -3,7 +3,13 @@
This guide helps you resolve common issues with HexOS installation, setup, and operation. Issues are organized by category for quick reference.
:::tip Quick Help
-Check our [Common Issues](./common-issues/) section or visit the [HexOS Community](https://hub.hexos.com/) for posts by other users.
+Check our [Common Issues](./common-issues/) section for frequently encountered problems:
+- [Application Errors](./common-issues/ApplicationErrors) - App installation, updates, and startup issues
+- [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
+
+Visit the [HexOS Community](https://hub.hexos.com/) for additional support from other users.
:::
## Installation Issues