Skip to main content

Preferences Window

Preferences is a separate window that shows everything the tray dropdown does plus more detail. It's opened via Preferences… from the tray menu.

Locai Link Preferences window showing the Device, Agent, Models, and Network panels

Device panel​

  • Name. The human-readable name you gave the device during Setup.
  • ID. The UUID Locai Control assigned during registration. Click Copy to copy the full ID (useful when reporting issues).
  • Version. The runtime version currently installed, e.g. 1.0.19. Pre-release builds append the release channel, for example 1.0.19 · Alpha.
  • Open in Control. Opens this device's page in the Locai Control dashboard.

Agent panel​

  • Status. A green Running pill or a red Stopped pill, plus uptime (· 2h 14m).
  • Stop / Restart. Stop the agent, or restart it (useful when troubleshooting).
  • Run at login. A toggle that enables / disables the LaunchAgent (macOS) or systemd user unit (Linux). Turning it off means the agent won't start on your next login until you launch Locai Link manually.

Network panel​

Shows the connection status to Locai Control:

  • Endpoint. The Zenoh router URL (e.g. tls/zenoh.locai.co.uk:7448). Zenoh is the messaging protocol Link uses.
  • Status. Connected (green) or Disconnected (red).

If Network shows Disconnected, the agent can't reach the Zenoh router. Most commonly a firewall blocking outbound TCP 7448; see Troubleshooting.

Models panel​

Same list as the tray Models submenu, but with more per-row detail:

  • In-flight downloads show a circular progress wheel + percentage + a Cancel button. Clicking Cancel stops the download immediately, cleans up the partial file, and drops the row.
  • Deployed models show their alias, port (if serving), and a Serve / Stop button.
  • Available to download. Models on your Locai account that aren't yet on this device. (Currently in preview; requires Control-side endpoint work to expose.)

Advanced​

  • Log file. Reveal the runtime's stdout log in Finder (macOS) or the file manager (Linux). Useful when troubleshooting.
  • Install root. The path where the runtime lives (/Library/Locai/ on macOS, ~/.local/share/locai/ on Linux by default).

Closing the Preferences window doesn't quit the companion; it stays running in the menu bar.