1. Home
  2. Docs
  3. Manual
  4. installation
  5. Fedora OS

Fedora OS

Enabling QSystemTrayIcon Support on Fedora (GNOME Desktop)

Qt’s QSystemTrayIcon relies on the system tray interface. On Fedora, GNOME Shell does not provide full tray support by default. The solution depends on the GNOME version you are running.


1. Fedora 30 ~ 34 (GNOME 3.32 ~ 3.38)

GNOME 3.x removed traditional XEmbed tray icons, so you need the AppIndicator extension:

# Install AppIndicator extension and dependencies
sudo dnf install gnome-shell-extension-appindicator libappindicator-gtk3 libappindicator-gtk3-devel gnome-tweaks

Enable the extension:

  • Open GNOME Tweaks → “Extensions” → enable AppIndicator Support
  • Or enable via command line: gnome-shell-extension-tool -e appindicatorsupport@rgcjonas.gmail.com
  • Log out / restart GNOME Shell for changes to take effect

2. Fedora 35 ~ 38 (GNOME 40 ~ 44)

These versions ship with the GNOME Extensions app, making it easier to enable extensions:

sudo dnf install gnome-shell-extension-appindicator gnome-extensions-app libappindicator-gtk3

Enable the extension:

  • Open Extensions from the Applications menu and enable AppIndicator and KStatusNotifierItem Support
  • Or enable it online at extensions.gnome.org

3. Fedora 39+ (GNOME 45 and newer)

Fedora now ships with AppIndicator support enabled by default.
You only need the Extensions app to manage it:

sudo dnf install gnome-extensions-app

Then confirm AppIndicator and KStatusNotifierItem Support is enabled (usually it is by default).