From a296cea62d7275532a2085f2505ab1e170f25210 Mon Sep 17 00:00:00 2001
From: Jerod Fritz <jerodfritz@gmail.com>
Date: Wed, 21 Jan 2026 11:52:49 -0500
Subject: [PATCH 1/2] Restructures troubleshooting guide navigation

Improves the troubleshooting documentation's navigation by nesting common issues under a dedicated section.

This change groups related troubleshooting topics, enhancing discoverability and providing a more organized user experience.
---
 docs/.vitepress/sidebar.ts                  | 14 +++++++++++---
 docs/troubleshooting/common-issues/index.md |  2 ++
 docs/troubleshooting/index.md               |  8 +++++++-
 3 files changed, 20 insertions(+), 4 deletions(-)

diff --git a/docs/.vitepress/sidebar.ts b/docs/.vitepress/sidebar.ts
index 5b164944..276e2d06 100644
--- a/docs/.vitepress/sidebar.ts
+++ b/docs/.vitepress/sidebar.ts
@@ -65,9 +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: 'Immich Migration', link: '/troubleshooting/common-issues/ImmichMigration' },
+      {
+        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' },
+        ]
+      },
     ]
   },
   {
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

From 75c4ff7241b826409daa9f97a6ce1b0e20e727a5 Mon Sep 17 00:00:00 2001
From: Jerod Fritz <jerodfritz@gmail.com>
Date: Wed, 21 Jan 2026 12:07:35 -0500
Subject: [PATCH 2/2] Creates link to app curation reset guide

Adds a link to the "Resetting App Curation" section within the troubleshooting documentation for application errors.
This allows users to easily navigate to the specific instructions when encountering issues related to mismatched storage locations or other curation problems in HexOS/TrueNAS installations.
---
 docs/troubleshooting/common-issues/ApplicationErrors.md | 2 +-
 1 file changed, 1 insertion(+), 1 deletion(-)

diff --git a/docs/troubleshooting/common-issues/ApplicationErrors.md b/docs/troubleshooting/common-issues/ApplicationErrors.md
index 7b83dfb5..9130f65f 100644
--- a/docs/troubleshooting/common-issues/ApplicationErrors.md
+++ b/docs/troubleshooting/common-issues/ApplicationErrors.md
@@ -122,7 +122,7 @@ Uploads: (HDDs/SSDs)/Photos/immich <br>
 Postgres: (HDDs/SSDs)/Applications/immich/postgres_data <br>
 
 
-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`
+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