1. Install
- macOS and Linux
- Windows
~/.local/bin/boxd.From an AI agent, or anywhere without a terminal to answer the installer’s questions, add --yes. Without it only the binary is installed; with it the installer also adds the agent skills, the PATH line and shell completions:2. Authenticate
- CLI
- TypeScript
- Python
Sign in with GitHub or Google:
3. Create a machine
boxd new boots a fresh machine in milliseconds.
- CLI
- TypeScript
- Python
region. myapp.boxd.sh is in Frankfurt, and a machine in New York gets myapp.nyc.boxd.sh. See Regions to pick one.
4. Get into the machine
- CLI
- SSH
exit or Ctrl-D to come back to the shell on your laptop.5. Serve something on your public URL
Every machine already has a public HTTPS address athttps://myapp.boxd.sh. It serves whatever listens on port 80, 443, 8080, 8000, 3000, 5000 or 5173, and falls back to port 8000. To see it working, start the nginx that comes pre-installed:
- CLI
- TypeScript
- Python
https://myapp.boxd.sh in your browser. You are looking at a server running on your machine, reachable by anyone you send the link to. Swap nginx for your own app on one of those ports and the same URL serves that instead.
6. Fork your machine
A fork is a full copy of the source machine exactly as it is right now, with the disk, the memory, and every running process included. Disk and memory are copy-on-write, so the fork arrives in under 200ms. Fork the machine you just set up:- CLI
- TypeScript
- Python
myapp-test, with its own URL at https://myapp-test.boxd.sh.
Running processes come with it. The nginx you started in step 5 is already serving on the fork’s URL. Nothing had to boot or start up again. Open both URLs side by side and you will see the same page twice.
7. Snapshot your machine
A snapshot is a saved copy of a machine’s memory and disk, kept under its own name. Where a fork gives you a live copy of a machine that is still running, a snapshot is a starting point you create machines from. No machine has to keep running for that, so it costs less. It stays around even after you delete the source machine. Savemyapp as a snapshot:
- CLI
- TypeScript
- Python
- CLI
- TypeScript
- Python
8. Make a checkpoint
A checkpoint is an undo button for one machine. Save one before you try something risky, and if it goes wrong, rewind the same machine back to that moment. The machine keeps its name and its URL. Save a checkpoint:- CLI
- TypeScript
- Python
- CLI
- TypeScript
- Python
9. Talk between machines
Machines can manage each other. The boxd CLI and both SDKs are already installed on every machine. Inside a private machine they act as the machine’s owner, fenced to that organization. Inside a shared machine they act for the organization’s shared machines only. There is no API key to copy in and nothing to configure. Get intomyapp as you did in step 4, then run any of these from in there:
- CLI
- TypeScript
- Python
10. Share a machine
Machines are private to you by default. Sharing one opens it to every member of your org, so a colleague can connect to it and work in the same machine.- CLI
- TypeScript
- Python
Next steps
Dive deeper into the guides, or explore the use cases.Development workspaces
A real computer for you and your team.
Preview environments
A URL for every pull request.
Coding agents
Give an agent its own machine to work in.
Personal assistants
An always-on machine your assistant lives on.
Sandboxes
Run untrusted code behind a hardware boundary.
Agentic SaaS offerings
Give every one of your users their own machine.