Getting started
Buy capacity and connect your coding agent to Heaven. To work from your own terminal, use the CLI to create a Computer, serve a website at its HTTPS address and open a shell.
On this page
Buy capacity
#If you already have access to a running pool, skip to connecting your agent or installing the CLI.
On the pricing page, choose Monthly and select Buy on the Tiny block (Plan 1). Sign up or sign in when prompted, then complete payment. If you don't manage an organization yet, Heaven creates one for you.
To buy from a terminal, install the CLI and sign in first. If you don't have an organization yet, use heaven organization create NAME with an available name. Run the purchase command with your organization's name in place of acme:
heaven capacity buy --plan 1 --monthly --organization acmeOpen the payment link from the command to complete the purchase.
The launch offer takes half off the first month of your organization's first monthly purchase. You can get a full refund if you release that purchase within 48 hours. See Pricing for the terms.
For hourly billing, choose Pay as you go on the pricing page, or use --hourly in place of --monthly with enough prepaid balance to cover the first hour.
Heaven puts the entire purchase into the organization's first pool. For an organization named acme, the pool is acme-pool. It's ready after payment for a monthly purchase, or immediately when you buy hourly capacity.
Connect your agent
#- MCP client. If your client supports Streamable HTTP and OAuth, add
https://heaven.dev/mcpas its hosted MCP server. Sign in through the client to give it your Heaven permissions. To run the server locally, install the CLI and sign in where the client runs. Runheaven mcp installto add Heaven to the supported clients it finds, or set up another client by hand. Restart your client if it's already running. - Terminal agent. Install the CLI where the agent runs, even on another machine. Run
heaven loginthere and approve the code it shows in your browser. The agent can find commands withheaven help. - Script, CI job or service. In SSH & API keys, create an API key with Read only access, or Custom for the commands it runs, and set it as
HEAVEN_API_KEYin the process's secret environment. The CLI reads this variable. For the HTTP API, send the key as a bearer token.
Ask your agent to list the Heaven Computers it can access. For a script, use heaven view or GET /v1/computer/ with a key that allows view. A successful list, even an empty one, confirms the connection.
Install the CLI
#If you installed the CLI to buy capacity, continue to signing in and selecting a pool.
To work from a terminal, install the CLI on your Mac or Linux computer:
curl -fsSL https://heaven.dev/install | sh
heaven versionThe CLI guide includes Windows installation.
Sign in and select a pool
#If you haven't signed in through the CLI yet, run:
heaven loginWhen you approve the sign-in in your browser, keep Add its SSH key selected so you can open a shell later. List your pools:
heaven pool viewFind the organization and pool names in the list. In the next command, use those names in place of acme and acme-pool.
Create a Computer
#heaven create my-site --organization acme --pool acme-pool --image heaven-ubuntu --wait=60s
heaven view my-siteContinue when the Computer reaches running and any setup script has finished. If it is still starting after the wait, run heaven view my-site again. Its state message reports progress and failures.
On November 19, 2026, nine creates of the default image on heaven.dev took 1.70 to 2.32 seconds from the create request until the Computer was running and reachable. The median was about 1.9 seconds. The client had about 30 ms of round-trip latency, and the first SSH command succeeded about 0.35 seconds after the Computer was ready. Create times vary.
Serve a website
#From your local terminal, write a page and start nginx:
heaven exec my-site 'printf "%s\n" "Hello from Heaven." | sudo tee /var/www/html/index.html >/dev/null'
heaven exec my-site 'sudo systemctl enable --now nginx'Set the website port and access:
heaven website my-site --port 8000 --access privateOpen https://my-site.heaven.dev and sign in. The page displays Hello from Heaven.
Open a shell
#heaven ssh my-siteThe shell opens as the image's login user.