Connecting to Computers
A running Computer is accessible through a browser terminal or SSH. Its HTTPS address serves websites and applications.
On this page
Browser terminal
#A Computer's Terminal action in the dashboard opens a shell using your Heaven sign-in. The shell runs as the image's login user.
Desktop
#The browser desktop opens a graphical session inside a running Computer. Use Google Chrome in that session to test a website, or watch an agent drive the browser through a task such as a sign-up flow. Everyone who opens the desktop sees and can control the same screen.
The Computer's owner and people with root access can open the desktop. Run this from your local terminal.
heaven desktop my-siteOpen the returned URL in your browser and sign in to Heaven. If you're already signed in, you can open the desktop directly at https://my-site.heaven.dev:6080/.
The default image, heaven-ubuntu, includes the desktop with Chrome. Older Computers keep the image version they were created with. Custom images can serve their own desktop on the reserved desktop port.
By default, the desktop and programs you started in it stop 15 minutes after the last viewer disconnects. Use a terminal session for work that needs to keep running after you leave the desktop.
Heaven CLI
#The CLI opens an SSH connection from your local terminal:
heaven ssh my-siteThe CLI uses the SSH key registered when you approve sign-in with Add its SSH key selected.
SSH
#Heaven's SSH gateway connects you to a Computer by name:
ssh my-site@heaven.devThe gateway authenticates against the public keys in SSH & API keys.
SCP and SFTP transfer files between your own machine and the Computer. Port forwarding makes a service inside the Computer, such as a database, available on a local port.
To open a project in VS Code or Cursor, connect your editor over SSH.
Sessions
#Use tmux to keep an interactive session running after you disconnect. Inside the Computer, run tmux new -s work. Press Ctrl-B, then D to detach. Run tmux attach -t work to reconnect to the session.
Services managed by systemd can also run independently of terminal connections and start at boot. A stop or restart ends the session.
Websites
#Each Computer has an HTTPS address, such as https://my-site.heaven.dev. Website access is private by default and requires sign-in.
Connection state
#Start a stopped Computer or resume a paused one before connecting. Logs contains boot output for diagnosing startup failures.