Skip to main content

System Tray and Close Prevention

Rostyman can minimize to the system tray instead of quitting when you close the window. This keeps the application running in the background, which is useful when you have long-running operations like mock servers, scheduled jobs, or active WebSocket connections.

Minimize to Tray on Close​

When you close the Rostyman window (by clicking the X button or pressing Alt+F4), the application minimizes to the system tray instead of quitting. This behavior keeps background operations running without occupying space on your taskbar.

A tray icon appears in the system notification area (bottom-right on Windows, top menu bar on macOS, system tray on Linux).

Restoring the Window​

To bring Rostyman back to the foreground:

  • Click the tray icon -- a single click restores the window to its previous size and position

The window returns exactly as you left it, with all tabs, connections, and state preserved.

Tray Right-Click Menu​

Right-click the tray icon to access a context menu with the following options:

OptionDescription
RestoreBrings the application window back to the foreground
QuitFully exits the application, stopping all background operations

Close Prevention Dialog​

If you attempt to quit Rostyman while active operations are in progress, a confirmation dialog appears warning you about the running operations. This prevents accidental interruption of:

  • Active mock servers
  • Running scheduled jobs
  • Open WebSocket, Socket.IO, or MQTT connections
  • In-progress collection runs
  • Active video recordings

The dialog presents two options:

  • Cancel -- returns to the application without closing
  • Quit Anyway -- forces the application to quit, stopping all active operations

This safeguard only appears when there are genuinely active operations. If nothing is running, the application minimizes to tray (or quits, depending on your action) without interruption.

Linux Graceful Fallback​

On Linux, system tray support depends on the desktop environment and its configuration. Some Linux distributions or window managers do not support tray icons natively.

When tray functionality is unavailable, Rostyman falls back gracefully:

  • The close button quits the application normally instead of minimizing to tray
  • The close prevention dialog still appears if active operations are detected
  • All other functionality remains unaffected

Common Linux desktop environments with tray support include GNOME (with extensions), KDE Plasma, XFCE, and Cinnamon.

Tips​

  • If you frequently run mock servers or scheduled jobs, the minimize-to-tray behavior lets you keep them running without cluttering your taskbar
  • Use Quit from the tray menu (not just closing the window) when you want to fully exit the application
  • The close prevention dialog respects all operation types -- if you see it, review which operations are active before choosing to quit