Skip to content
GitHub Download

Using the desktop

How the HeadlessOS desktop works, including windows, the dock, launcher, menu bar, Quick Settings, notifications, Home hub and keyboard shortcuts.

After you connect to a server, HeadlessOS shows it as a desktop. Every window belongs to that server. To work with several, see Sessions and Fleet.

Double-click a desktop icon, or use the dock, launcher or command palette. Right-click the desktop for more apps. Most apps have one window per server, and opening one again brings it forward.

Docker needs docker on the server, and Services needs systemctl. The other apps need nothing specific, though some Server Admin sections use their own tools.

  • Move: drag the title bar.
  • Resize: drag the bottom-right corner.
  • Maximize: double-click the title bar, or drag it to the top edge.
  • Snap: drag the title bar to a side for half the screen, or a corner for a quarter.

Right-click the title bar for Minimize, Close and Move to session.

The dock holds Launcher, Home hub, Search, pinned apps, other open apps and Recycle Bin.

Click an app to open it or bring it forward. Click the front app to minimize it.

Right-click an app for Pin to Dock or Unpin from Dock, and Close Window. Right-click the dock for Show Desktop.

A maximized window takes the dock’s space, so the dock slides away. To bring it back, do any of these:

  • Hover over the thin handle at the edge of the screen, or click it.
  • Click Show launcher in the top bar. It’s there only while the dock is away.
  • Press Tab until you reach the dock.

The dock floats over the app, and slides away again when you move off it or click somewhere else.

With the dock on the right, a maximized window stops just short of the edge, so the handle stays clear of the window’s scrollbar.

Click Launcher or press Ctrl+Space. Search apps, or use the quick actions, the app grid, My Apps (views you saved as apps) and Recent.

Lock covers the desktop with a clock and stays connected. It asks for no password: any key leads to Control Center. Switch User and Sign Out both disconnect the server and go to Control Center.

The menu bar runs along the top. Click its three status icons to open Quick Settings:

ControlWhat it does
ServerConnects or disconnects the server
NotificationsTurns pop-up notifications on or off
DarkSwitches between dark and light
Glass, AccentChange transparency and accent colour
DesktopMinimizes all windows, or restores them
PersonalizeOpens wallpaper settings

All settings opens Settings.

Click the date and time. A dot means something is unread. The panel lists notifications above a calendar, with Mark all read and Clear all. It currently records File Explorer uploads. The list clears when you reload or quit the app.

Click Home hub in the dock for a full-screen view of one server. Press Escape to close it. Pick another server in the bar at the bottom.

The Home hub for web-01, with cards for server health, recent apps, weather, connection and network traffic

  • Server health: a dial for CPU, Memory or Disk. The light turns amber at 75% and red at 90%.
  • Recent apps: your last few apps.
  • Network traffic: download above the line, upload below, with Peak, Average and Total. Click the time axis for the last 1, 5 or 15 minutes. It records only while the hub is open.
  • Weather: set a city in Settings. Forecasts come from Open-Meteo, which receives the city, not your server data.
  • Display: brightness and night light for HeadlessOS.

Press Ctrl+K or click Search. Find apps, saved apps, theme actions and Settings pages.

KeysAction
Ctrl+SpaceLauncher
Ctrl+KCommand palette
Ctrl+DShow or restore the desktop
Alt+F4Close the window
Ctrl+Up, Ctrl+DownMaximize; restore or minimize
Ctrl+Left, Ctrl+RightSnap left or right
Ctrl+1 to Ctrl+9Switch session
Ctrl+Tab, Ctrl+Shift+TabNext or previous session
Ctrl+Shift+HHibernate this session
Ctrl+Shift+SpaceOpen Control Center

On a Mac, Cmd also works unless macOS uses the key. Most shortcuts are ignored while you type in a field or the terminal. A browser may catch some first, such as Ctrl+Tab.