Docs
Read https://orble.tech/setup.md and follow it to set up Orble for me.Add the server yourself
https://orble.tech/mcpClaude
Claude Code
claude mcp add --transport http orble https://orble.tech/mcpThen run /mcp in Claude Code to sign in.
Codex
[mcp_servers.orble]
url = "https://orble.tech/mcp"
Then run codex mcp login orble to sign in.
Cursor
Or by hand:
{
"mcpServers": {
"orble": {
"url": "https://orble.tech/mcp"
}
}
}
VS Code
Windsurf
In Cascade, open the MCP servers' config file.
{
"mcpServers": {
"orble": {
"serverUrl": "https://orble.tech/mcp"
}
}
}
Gemini CLI
gemini mcp add --transport http orble https://orble.tech/mcpThen run /mcp auth orble in Gemini CLI to sign in.
opencode
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"servers": {
"orble": {
"type": "remote",
"url": "https://orble.tech/mcp"
}
}
}
}
Then run opencode mcp auth orble to sign in.
Zed
Add this key to Zed's settings:
"context_servers": {
"orble": {
"url": "https://orble.tech/mcp"
}
}
Tools
- list_boxes
- List boxes (read-only)
- create_box
- Create a box
- fork_box
- Fork a box
- snapshot_box
- Save a snapshot of a box
- list_snapshots
- List snapshots (read-only)
- rename_box
- Rename a box
- resize_box
- Resize a box
- rename_snapshot
- Rename a snapshot
- delete_snapshot
- Delete a snapshot
- delete_box
- Delete a box
- suspend_box
- Suspend a box
- resume_box
- Resume a box
- exec
- Run a command in a box
- read_file
- Read a file from a box (read-only)
- write_file
- Write a file in a box
- share_port
- Share a box's port
- set_box_network
- Set a box's outbound rules
- list_secrets
- List secrets (read-only)
- list_networks
- List box networks (read-only)
- join_network
- Put a box in a network
Install
curl -fsSL https://orble.tech/install.sh | shorble new
Boxes
- orble new
- Create a box
- --size s|m|l
- Pick a size (see Pricing). Short: -s
- --name <name>
- Name it. Its generated name works too
- orble rename <box> <name>
- Rename a box. Its first name, hostname and ssh keep working
- orble resize <box> <m|l>
- Restart a box at a larger size. Its files stay; running programs stop
- orble ls
- List boxes and their state, each fork under the box it was forked from (--json for JSON)
- orble ssh <box> [ssh args]
- SSH in. With IPv6,
ssh <box>.<account>.orble.techworks too - orble vnc <box>
- Open the desktop in your browser
- orble desktop <box> [--off]
- Open the desktop in a VNC viewer
- orble suspend <box>
- Suspend
- orble resume <box>
- Resume
- orble rm <box> [-y]
- Delete the box and its disk
- orble fork <box> [-n N]
- Fork into 1 to 10 new boxes, running programs included
- orble port <box> [port]
- Share a port at its own HTTPS address, private to your account, or list the shared ports
- --public
- Open it to anyone with the address
- --private
- Only your account again
- --off
- Stop sharing it
- orble exit-node [box...]
- Send boxes' traffic through this machine while it runs
- --lan
- Let boxes reach your local network
- --fallback
- Use Orble's network while this machine is offline
Snapshots
You can build a custom image from a Dockerfile or freeze an existing box with its running programs. You pay the standard storage price. Orble runs microVMs, not containers, so a build runs your Dockerfile's steps in a box and saves the whole machine.
- orble snapshot <box> [name]
- Save a snapshot
- orble snapshot build [-f Dockerfile] [name]
- Build one from a Dockerfile; FROM orble.tech/base, or orble.tech/<snapshot>
- --start <command>
- Keep a program running in every box made from it
- orble snapshots
- List yours and Orble's (--json for JSON)
- orble new --from <snapshot>
- Make a box from one;
-sfor a larger size - orble snapshot rm <snapshot>
- Delete a snapshot
- orble snapshot rename <snapshot> <name>
- Rename a snapshot
Account
- orble login
- Sign in with Google or GitHub
- orble keys
- List SSH keys
- orble keys add [file]
- Add an SSH key
- orble keys rm <fingerprint>
- Remove an SSH key
- orble account
- Show your account, credit and plan
- orble topup [amount]
- Add credit
Egress rules
Choose what a box may reach on the internet, and change it while the box runs. Orble Pro.
- orble net <box>
- Show its rules
- orble net block <box>
- Block everything its allow list doesn't name
- orble net allow <box> <entry...>
- Allow IPv4 addresses, CIDRs,
example.comor*.example.com - orble net deny <box> <entry...>
- Deny them
- orble net rm <box> <entry...>
- Remove entries
- orble net open <box>
- Remove every rule
- Limits
- 100 entries per box. A blocked box resolves only names it may reach, and its secrets reach only hosts it may reach. Rules apply to forks and snapshots, and don't mix with an exit node
Secrets
Store an API key once. Your boxes get a placeholder, and Orble adds the key to their requests on the way out. Orble Pro.
orble secret set STRIPE_API_KEY --host api.stripe.comcurl $STRIPE_API_KEY_URL/v1/balance
- orble secret set <NAME> --host <host>
- Add or change a secret; the value comes from a prompt or stdin
- --header <name> --format <format>
- The header it fills, and how:
Authorization,Bearer {} - --box <box>
- Only this box (repeat for more); every box without it
- --intercept
- Also add it to HTTPS requests to its hosts that send
$NAMEin its header - orble secret ls
- List secrets, never their values
- orble secret rm <NAME>
- Delete a secret
- In a box
$NAMEis the placeholder.$NAME_URL/<path>goes to the secret's first host with the key- Base URLs
- A secret for api.anthropic.com, api.openai.com or api.github.com also sets
ANTHROPIC_BASE_URL,OPENAI_BASE_URLorGITHUB_API_URL - Limits
- 50 secrets, HTTP headers only. --intercept adds your account's CA to the box's certificates. Claude and ChatGPT sign-ins stay in the box
Box networks
Boxes in a network reach each other on any port, at their addresses or as <box>.<network>.internal. A connection to a suspended box wakes it. Orble Pro.
- orble net create <network>
- Make a network
- orble net join <network> <box>
- Put a box in it
- orble net leave <network> <box>
- Take a box out
- orble net ls
- List networks, their boxes and addresses
- orble net delete <network>
- Delete a network
- Limits
- 10 networks of up to 50 boxes. Forks join their source's networks
From E2B
To run code written for the E2B SDK on Orble, set these two variables, with a key you make in Settings.
export E2B_DOMAIN=orble.techexport E2B_API_KEY=orble_...
from e2b import Sandbox
sbx = Sandbox.create()
print(sbx.commands.run("echo hello").stdout)
sbx.kill()
- Works
- Sandbox.create, connect, list, kill, set_timeout, pause, create_snapshot, fork, commands, PTY, files, watch_dir and get_host, in the Python and JavaScript SDKs, and the code interpreter and desktop SDKs
- Templates
base(2 vCPU, 4 GiB),m(4 vCPU, 8 GiB) andl(8 vCPU, 16 GiB), all Debian 13 with Python, Node.js and Docker- Pro
- network rules:
allow_internet_access,allowOut,denyOutandupdate_network(Egress rules) - Not yet
- Template.build, volumes and secrets
From Daytona
To run code written for the Daytona SDK on Orble, set these two variables, with a key you make in Settings.
export DAYTONA_API_URL=https://api.orble.tech/daytonaexport DAYTONA_API_KEY=orble_...
from daytona import Daytona
sandbox = Daytona().create()
print(sandbox.process.exec("echo hello").result)
sandbox.delete()
- Works
- create, get, list, start, stop, delete, labels, auto-stop, auto-delete, preview links, snapshots, fork, process.exec, code_run, sessions, PTY sessions, files, signed file URLs, git, LSP and computer use, in the Python and JavaScript SDKs
- Sizes
- you get the smallest box with the
cpuandmemoryyou ask for: 2 vCPU and 4 GiB, 4 and 8, or 8 and 16, all Debian 13 with Python, Node.js and Docker - Pro
networkBlockAll,networkAllowList,domainAllowListand network settings on a running sandbox (Egress rules)- Not yet
- your own images, volumes, secrets, and computer use's recordings and accessibility tree