Skip to main content
The runcloud/desktop image gives a sandbox a graphical Linux desktop that you can open in a browser or control from an agent.

​
Open a desktop

Create the sandbox and keep its ID:
Open the desktop in your default browser:
To embed or open the desktop yourself, print its signed noVNC URL:
Desktop URLs are temporary bearer credentials. Keep them out of logs, issue trackers, and public chat.

​
View-only access

Use a view-only desktop when someone or something should observe the screen without sending keyboard or pointer input:
Combine --view-only with --url to print the corresponding signed URL.

​
Control the desktop from an agent

Capture the current screen:
Send pointer and keyboard input:
Coordinates are measured in pixels from the top-left corner. key accepts xdotool-style key names and chords such as Return, ctrl+l, or alt+F4. Destroy the sandbox when the job is finished: