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