Skip to content

Add troubleshooting note for the Linux tray icon #60

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
merged 1 commit into from
Jul 21, 2025
Merged
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
27 changes: 27 additions & 0 deletions docs/toolhive/guides-ui/install.mdx
Original file line number Diff line number Diff line change
Expand Up @@ -227,6 +227,33 @@ If the retry button doesn't work, try restarting ToolHive.

</details>

<details>
<summary>No system tray icon on Linux</summary>

Recent versions of Fedora Linux and other distributions have removed the
AppIndicator extension from their default installations. ToolHive requires this
extension for the system tray icon to work properly.

On Fedora, install the `gnome-shell-extension-appindicator` package:

```bash
sudo dnf install gnome-shell-extension-appindicator
```

You'll need to log out and log back in to activate the extension.

Alternatively, install the
[Extension Manager](https://github.com/mjakeman/extension-manager) app. It's
available as a native package in many distributions, or you can install it from
[Flathub](https://flathub.org/apps/com.mattjakeman.ExtensionManager). Then, use
Extension Manager to install the
[AppIndicator](https://extensions.gnome.org/extension/615/appindicator-support/)
extension (listed as "AppIndicator and KStatusNotifierItem Support").

The ToolHive icon should now appear in your system tray.

</details>

### Other issues

For other installation issues, check the
Expand Down
Loading