Skip to content

Commit 199573a

Browse files
authored
Add troubleshooting note for the Linux tray icon (#60)
1 parent 6fe96e9 commit 199573a

File tree

1 file changed

+27
-0
lines changed

1 file changed

+27
-0
lines changed

docs/toolhive/guides-ui/install.mdx

Lines changed: 27 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -227,6 +227,33 @@ If the retry button doesn't work, try restarting ToolHive.
227227

228228
</details>
229229

230+
<details>
231+
<summary>No system tray icon on Linux</summary>
232+
233+
Recent versions of Fedora Linux and other distributions have removed the
234+
AppIndicator extension from their default installations. ToolHive requires this
235+
extension for the system tray icon to work properly.
236+
237+
On Fedora, install the `gnome-shell-extension-appindicator` package:
238+
239+
```bash
240+
sudo dnf install gnome-shell-extension-appindicator
241+
```
242+
243+
You'll need to log out and log back in to activate the extension.
244+
245+
Alternatively, install the
246+
[Extension Manager](https://github.com/mjakeman/extension-manager) app. It's
247+
available as a native package in many distributions, or you can install it from
248+
[Flathub](https://flathub.org/apps/com.mattjakeman.ExtensionManager). Then, use
249+
Extension Manager to install the
250+
[AppIndicator](https://extensions.gnome.org/extension/615/appindicator-support/)
251+
extension (listed as "AppIndicator and KStatusNotifierItem Support").
252+
253+
The ToolHive icon should now appear in your system tray.
254+
255+
</details>
256+
230257
### Other issues
231258

232259
For other installation issues, check the

0 commit comments

Comments
 (0)