Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 11 additions & 3 deletions docs/.vitepress/sidebar.ts
Original file line number Diff line number Diff line change
Expand Up @@ -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' },
]
},
]
},
{
Expand Down
2 changes: 1 addition & 1 deletion docs/troubleshooting/common-issues/ApplicationErrors.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
2 changes: 2 additions & 0 deletions docs/troubleshooting/common-issues/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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/).
Expand Down
8 changes: 7 additions & 1 deletion docs/troubleshooting/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down