System Tray

lerd tray launches a system tray applet that gives you at-a-glance status and one-click control without opening a browser.

lerd tray              # launch (detaches from terminal automatically)
lerd tray --mono=false # use the red colour icon instead of monochrome white

The tray detaches from the terminal immediately, your shell prompt returns straight away.

---

Menu layout

🟢 Running          ← overall status (disabled, informational)
  🟢 nginx
  🟢 dns
─────────────────
Open Dashboard       ← opens http://127.0.0.1:7073
Stop Lerd            ← toggles between Start / Stop Lerd
─────────────────
── Services ──
  🟢 mysql           ← click to stop
  🔴 redis           ← click to start
─────────────────
── PHP ──
  ✔ 8.5              ← current default (click to switch)
  8.4
─────────────────
Autostart at login: ✔ On   ← click to toggle (enables/disables every lerd unit)
⬆ Update to v0.8.3         ← shown when an update is cached; click to open terminal
Stop Lerd & Quit     ← runs lerd stop then exits the tray

The menu refreshes every 5 seconds. Clicking a service toggles it on/off. Clicking a PHP version sets it as the global default. "Stop Lerd & Quit" stops the entire environment before closing.

The Services section shows only core services (MySQL, Redis, PostgreSQL, etc.). Per-site workers (queue, schedule, Stripe, Reverb) are managed from the web UI or via their respective CLI commands and are not listed in the tray.

The update item shows "Check for update..." when no update information is cached, and "⬆ Update to vX.Y.Z" once the background checker finds a newer release. Clicking it opens a terminal to run lerd update.

---

Autostart

The tray follows the global lerd autostart toggle: when autostart is on (the default), lerd install writes and enables lerd-tray.service so the tray comes up on every graphical login. Run lerd autostart disable to turn off autostart for the entire environment, including the tray.

The tray is also started automatically by lerd start if it isn't already running.

The unit is wired to graphical-session.target, which is reached automatically by GNOME, KDE Plasma, and any Wayland compositor launched through uwsm (including Omarchy's Hyprland setup). On bare Hyprland / Sway / i3 launched without uwsm, graphical-session.target is never started, so the tray will not autostart. Either run the compositor under uwsm or replace WantedBy=graphical-session.target with WantedBy=default.target in ~/.config/systemd/user/lerd-tray.service.

---

Desktop environment compatibility

The tray uses the StatusNotifierItem (SNI) / AppIndicator protocol (DBus-based).

Environment	Status
KDE Plasma	Works out of the box
GNOME	Requires the AppIndicator and KStatusNotifierItem Support extension
Sway / Hyprland with waybar	Works with "tray" module in waybar config
i3 with i3bar	Requires snixembed to bridge SNI to XEmbed
XFCE / LXQt	Works out of the box

---

Build requirements

The tray uses CGO and requires libayatana-appindicator at build time:

Arch / CachyOS / omarchy

sudo pacman -S libayatana-appindicator

Debian / Ubuntu

sudo apt install libayatana-appindicator3-dev

Fedora

sudo dnf install libayatana-appindicator-gtk3

For headless / CI builds without the tray:

make build-nogui   # produces ./build/lerd-nogui (lerd tray returns an error)