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