Skip to content

aos headless

Run the desktop commands on a machine with no screen

4 commands. Run aos headless --help for the same list from the binary, or see every group.

Run aos on a machine with no screen. status says whether a display is available and where it came from. On Linux, start launches a virtual display with Xvfb and an optional window manager, later commands adopt it automatically, and stop tears it down. run executes one command against the managed display explicitly. See headless machines.

Run a command against the managed virtual display

Terminal window
aos headless run <command> [args...]
flag values meaning
<command> Required positional argument
Terminal window
aos headless run aos window list

Start a virtual display, so window and input commands work

linux only

Terminal window
aos headless start [--display=:99] [--size=<WxH>] [--wm]
flag values meaning
--display <:99> Optional
--size <WxH> Optional
--wm Optional
Terminal window
aos headless start
aos headless start --display=:101 --size=1920x1080 --wm

Report whether a display is available, and where it came from

Terminal window
aos headless status
Terminal window
aos headless status

Stop the virtual display this machine started

linux only

Terminal window
aos headless stop
Terminal window
aos headless stop