# Connecting to Computers

URL: https://heaven.dev/docs/connecting
Updated: 2026-11-21

A running Computer is accessible through a browser terminal or SSH. Its HTTPS address serves websites and applications.

## Browser terminal

A Computer's **Terminal** action in the [dashboard](https://heaven.dev/dashboard) opens a shell using your Heaven sign-in. The shell runs as the [image's login user](https://heaven.dev/docs/computers#default-image).

## 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.

```sh
heaven desktop my-site
```

Open 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](https://heaven.dev/docs/computers#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](https://heaven.dev/docs/networking#development-ports).

By default, the desktop and programs you started in it stop 15 minutes after the last viewer disconnects. Use [a terminal session](https://heaven.dev/docs/connecting#sessions) for work that needs to keep running after you leave the desktop.

## Heaven CLI

The [CLI](https://heaven.dev/docs/cli#install-and-sign-in) opens an SSH connection from your local terminal:

```sh
heaven ssh my-site
```

The CLI uses the SSH key registered when you approve sign-in with **Add its SSH key** selected.

## SSH

Heaven's [SSH gateway](https://heaven.dev/docs/ssh) connects you to a Computer by name:

```sh
ssh my-site@heaven.dev
```

The gateway authenticates against the public keys in [SSH & API keys](https://heaven.dev/dashboard/settings/keys).

[SCP and SFTP](https://heaven.dev/docs/ssh#file-transfers) transfer files between your own machine and the Computer. [Port forwarding](https://heaven.dev/docs/ssh#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](https://heaven.dev/docs/ssh#remote-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](https://heaven.dev/docs/computers#files-and-processes) ends the session.

## Websites

Each Computer has an [HTTPS address](https://heaven.dev/docs/networking#http-and-tls), such as `https://my-site.heaven.dev`. Website access is private by default and requires sign-in.

## Connection state

Start a [stopped Computer](https://heaven.dev/docs/computers#states) or resume a paused one before connecting. **Logs** contains boot output for diagnosing startup failures.
