Skip to main content
If you are an agent reading this doc, visit llms.txt, llms-full.txt, or skill.md instead.
1

SSH to boxd

ssh boxd.sh
If your key isn’t linked yet, you’ll see:
Your SSH key is not linked to a boxd account.

Open this URL to sign up or link your key:

  https://boxd.sh/?session=95b750ef-...

Waiting...
Keep this terminal open. Open the URL in your browser and click Sign in with GitHub to link key. GitHub only requests public data — no access to your repos or email.Once authorized, your terminal confirms:
Linked! Welcome, gh-yourname.
Please reconnect.
To skip host key prompts, add this to ~/.ssh/config:
Host boxd.sh
    StrictHostKeyChecking no
    UserKnownHostsFile /dev/null
2

Create a machine

ssh boxd.sh new --name=myapp

   name: myapp
     id: 9645b1e8-193d-4d11-86b1-f91deff5bbfb
     ip: 5.135.42.17
   boot: 1.8s
Your machine is running with a public IP and HTTPS domain.
3

Make it live

nginx is pre-installed on port 8000 (the default proxy port). Start it:
ssh boxd.sh exec myapp -- sudo systemctl start nginx
Visit https://myapp.boxd.sh — your machine is live on the internet.

​
Adding more SSH keys

SSH from a different machine with a new key and go through the same link flow. The new key gets linked to your existing account (matched by GitHub identity).

​
Start using your machine

Your machine is running. Now explore what you can do with it.

Control plane

Run commands, manage proxies, JSON output.

Direct SSH

Shell access, SCP, and port forwarding.

HTTPS

Automatic domains, configurable ports.