10.2. System Tray¶
Backend.AI GO provides a system tray icon for quick access to the application and common actions when running in the background.
Overview¶
The system tray icon allows you to:
- Quickly show or focus the main window
- Control the API server
- Manage loaded models
- Navigate to key pages
- Access system folders
Platform Support¶
| Platform | Location | Left-Click | Right-Click |
|---|---|---|---|
| macOS | Menu bar | Show window | Context menu |
| Windows | System tray | Show window | Context menu |
| Linux | System tray | Context menu* | Context menu |
Linux Limitation
On Linux, left-click events may not be emitted due to platform limitations. Use right-click to access the context menu.
Context Menu Options¶
Right-click the tray icon to access the following options:
Server Controls¶
| Menu Item | Description |
|---|---|
| API Server Running / Stopped | Status indicator showing current server state |
| Start / Stop API Server | Toggle the API server on or off |
| Copy API Endpoint | Copy the API endpoint URL to clipboard (available when server is running) |
Model Management¶
| Menu Item | Description |
|---|---|
| Models (N loaded) | Submenu showing all loaded models; click a model to unload it |
| Unload All Models | Unload all currently loaded models at once |
Quick Navigation¶
| Menu Item | Description |
|---|---|
| Open Chat | Navigate directly to the Chat page |
| Open Models | Navigate to the Models management page |
| Open Monitor | Navigate to the Statistics/Monitor page |
System Integration¶
| Menu Item | Description |
|---|---|
| Open Models Folder | Open the models directory in your file manager |
| Open Logs Folder | Open the logs directory in your file manager |
Basic Actions¶
| Menu Item | Description |
|---|---|
| Show | Display and focus the main application window |
| Settings | Open the Settings page directly |
| Quit | Exit the application completely |
Enabling/Disabling the Tray Icon¶
To toggle the system tray icon:
- Open the application
- Navigate to Settings → General
- Find the Show tray icon toggle
- Enable or disable as desired
The setting takes effect immediately without requiring a restart.
Default Behavior¶
- The tray icon is enabled by default
- When enabled, the icon appears on application startup
- The setting persists across application restarts
Localization¶
The tray menu automatically updates when you change the application language. All menu items are available in both English and Korean.
Dynamic Updates¶
The tray menu updates automatically when:
- The API server starts or stops
- Models are loaded or unloaded
- The application language is changed
Troubleshooting¶
Tray icon not appearing¶
- Check if the setting is enabled in Settings → General
- On some Linux distributions, you may need to install a system tray extension (such as AppIndicator)
- Restart the application if the icon doesn't appear after enabling
Tray icon not responding to clicks (Linux)¶
This is a known limitation on Linux. Use right-click to access the context menu instead.
Icon persists after quitting¶
If the tray icon remains after quitting the application:
- This is typically a system-level cache issue
- Moving your mouse over the icon should cause it to disappear
- Logging out and back in will clear any stuck icons