# InstaBox changelog https://instabox.sh/changelog.md What changed in InstaBox, newest first. ## Docs revamped with Mintlify https://instabox.sh/changelog/docs-mintlify.md 2026-11-06 · Docs The InstaBox docs now run on Mintlify at instabox.sh/docs. Ask the assistant a question on any page, or hand a page to your coding agent as Markdown. - Press ⌘I (Ctrl+I on Windows and Linux) on any page to ask the assistant. It answers from the docs and links the page. - The menu next to each page's title copies it as Markdown, opens it in Claude or ChatGPT, or adds the docs MCP server to Cursor or VS Code. - Agents can read every page as Markdown, list them all in [llms.txt](https://instabox.sh/docs/llms.txt), and search them with the docs MCP server. See the [docs](https://instabox.sh/docs). ## Python SDK on PyPI https://instabox.sh/changelog/python-sdk.md 2026-11-05 · API The InstaBox Python SDK is now on PyPI as instabox-sdk. Create a box, run commands in it, move files, pause, snapshot and delete it from Python 3.9 to 3.13. Run `pip install instabox-sdk`, set `INSTABOX_API_KEY`, then import it as `instabox`: ```python from instabox import Client client = Client() box = client.machines.create(name="py-demo") r = client.machines.exec(box.id, "python3 -c 'print(6 * 7)'") print(r.exit_code, r.stdout) client.machines.delete(box.id) ``` Every call is listed on its [PyPI page](https://pypi.org/project/instabox-sdk/); the [Python SDK docs](https://instabox.sh/docs/python-sdk.md) walk through the common ones. ![pip install instabox-sdk, then a script that creates a box, runs a command in it and deletes it, printing the exit code 0 and 42](https://instabox.sh/changelog/images/2026-11-05-python-sdk/python-sdk.webp) ## Pay with Alipay https://instabox.sh/changelog/alipay.md 2026-11-04 · Billing, Dashboard You can now pay for the Pro and Builder plans with Alipay. When you upgrade with no card saved, checkout offers Alipay next to card. Stripe offers Alipay to customers in China. It renews each month on its own, like a card. A subscription already paying by card keeps it. Alipay limits how much one charge can be, which is why Team takes a card. A month of heavy usage can still go over that limit, and then the charge fails. Moving an Alipay plan to Team charges your card on file, so add one on the billing portal first. ## The Builder plan https://instabox.sh/changelog/builder-plan.md 2026-11-03 · Billing, Dashboard Builder is a new $100 a month plan between Pro and Team, with machines up to 16 vCPU / 32 GiB, 200 concurrent machines, 1 TiB of disk and 5 TiB of egress included. Builder is $100 a month and includes $100 of usage, like the other plans. Usage beyond that is pay as you go at list prices. It is for fleets that outgrew Pro without needing Team. | | Pro | Builder | Team | | ------------------- | --------------- | ---------------- | ---------------- | | Monthly fee | $20 | $100 | $500 | | Largest machine | 8 vCPU / 16 GiB | 16 vCPU / 32 GiB | 32 vCPU / 64 GiB | | Concurrent machines | 100 | 200 | 500 | | Machines | 500 | 1,000 | Unlimited | | Starts a minute | 30 | 50 | 100 | | Disk included | 200 GiB | 1 TiB | 5 TiB | | Disk per machine | Up to 200 GiB | Up to 500 GiB | Up to 1 TiB | | Egress a month | 1 TiB | 5 TiB | 50 TiB | Snapshots are unlimited, auto-pause is your choice or never, and members have no seat fee, as on Pro. Pick Builder on the Billing page, or when you make a new workspace. An upgrade takes effect at once, a downgrade at the next renewal. On Builder, the create dialog and `instabox create --vcpus 16 --mem-mib 32768` offer the 16 vCPU / 32 GiB size. See [Pricing](https://instabox.sh/pricing). ## CLI, skills and MCP for every coding agent https://instabox.sh/changelog/agent-mcp-skills.md 2026-11-01 · CLI, Templates, Machines Every box ships with the instabox CLI, the agent skills and the InstaBox MCP. The same three install on your laptop with one command. Claude Code, Codex, Cursor, OpenCode and Antigravity. Your coding agent knows how to use InstaBox, inside a box and outside it. **Inside a box.** Claude Code and Codex come with the InstaBox MCP connected, the `instabox` CLI at `/usr/local/bin/instabox`, and the skills in `~/.claude/skills` and `~/.agents/skills`. Every box built on the shared layer has this: agent-browser, universal, t3, herdr, orca and android. ![Claude Code's /mcp panel inside a box: Instabox MCP Server, connected, 24 tools](https://instabox.sh/changelog/images/2026-11-01-agent-mcp-skills/claude-mcp-in-a-box.webp) The MCP explains the machine on its own. Give it an API key as a Secret named `INSTABOX_API_KEY`, allowed for `api.instabox.sh`, and the agent can also create, run commands on and snapshot your other boxes. **Outside a box.** Two commands install the same three: ``` npx instabox@latest instabox mcp init claude ``` `mcp init` takes `claude`, `cursor`, `codex`, `opencode` or `antigravity`. See [MCP](https://instabox.sh/docs/mcp.md) and [CLI](https://instabox.sh/docs/cli.md). ## Usage alerts and billing emails https://instabox.sh/changelog/usage-alerts.md 2026-10-31 · Billing, Dashboard, CLI Paid workspaces now get an email at 80% of the month's included usage, when it is used up, when a charge is made, and when a payment fails. Set the usage percent, or turn it off, on the Billing page or with instabox workspace alerts. The owner and admins of a paid workspace now get these emails, each at most once per month or event: - **80% used.** Usage has reached 80% of what the month includes: the plan's allowance plus any credits. The percent is yours to set. - **All used.** Usage went past what is included. A card-paid workspace is now on pay as you go, up to its spend cap; a credits-funded one has stopped until it adds credits or renews. - **Charged.** A pay-as-you-go charge was made, with the amount. - **Payment failed.** The card payment failed, and a reminder before the workspace is cancelled. The account emails stay as they were: account disabled or restored, and early free sandboxes ending. ![The 80% email as it arrives: tonychang04 has used 80% of its included usage for October, with an Open Billing button](https://instabox.sh/changelog/images/2026-10-31-usage-alerts/usage-alert-email.webp) ![The Billing page's Usage alerts card: At 80%, pay as you go, with an Edit button](https://instabox.sh/changelog/images/2026-10-31-usage-alerts/usage-alerts-card.webp) Change the percent or turn the emails off on the dashboard's Billing page, or from the CLI: ``` instabox workspace alerts my-team --usage 90 instabox workspace alerts my-team --usage off --overage off ``` See [Billing](https://instabox.sh/docs/billing.md). ## Webhooks https://instabox.sh/changelog/webhooks.md 2026-10-27 · API, CLI, Dashboard InstaBox now sends a signed POST to your HTTPS endpoint when a sandbox is created, starts, stops, pauses, fails or is deleted, and when a snapshot is saved, fails or is deleted. You no longer need to poll for state changes. Add an endpoint on the dashboard's Webhooks page, or with the CLI: ``` instabox webhooks create https://example.com/hooks --event sandbox.started instabox webhooks test wh_... instabox webhooks deliveries wh_... ``` The signing secret is shown once. Requests follow the [Standard Webhooks](https://www.standardwebhooks.com/) spec, so you can verify them with its libraries. Failed deliveries are retried for about 28 hours, and the delivery log keeps each attempt for 30 days. Workspace owners and admins manage webhooks, from the dashboard, the CLI, or the API with an API key. See [Webhooks](https://instabox.sh/docs/webhooks.md). ![The dashboard Webhooks page with Webhooks selected in the sidebar, 0 of 10 endpoints and an Add endpoint button](https://instabox.sh/changelog/images/2026-10-27-webhooks/webhooks-page.webp) ## Metrics for every sandbox https://instabox.sh/changelog/sandbox-metrics.md 2026-10-27 · Dashboard, CLI Every sandbox now has a Metrics tab in the dashboard, with CPU, memory, network and disk I/O for the last hour or day. You can see what a box is doing, and how much it sends out, without opening a shell on it. Open a sandbox and pick Metrics. The host takes a sample every 30 seconds, and the Network chart's title adds up the egress for the range you picked. Looking at the tab never wakes a paused sandbox. The same numbers are in the CLI: ``` instabox metrics dev instabox metrics dev --since 6h --json ``` The Network chart counts the sandbox's own traffic. SSH sessions and public ports go through our gateway, so the chart leaves them out, but they still count toward the egress on your bill. ![A running sandbox's Metrics tab: CPU, Memory, Network with the egress total for the last hour, and Disk I/O charts](https://instabox.sh/changelog/images/2026-10-27-sandbox-metrics/metrics-tab.webp) ## Support center https://instabox.sh/changelog/support-center.md 2026-10-26 · Dashboard, CLI The dashboard now has a Support page where you open a ticket and read the team's replies. Tickets you start from the CLI, or on Discord once you link your account, are listed there too. Open the account menu at the top right and choose Support, then New ticket. Reply to or close an open ticket on the same page. From the CLI, file a report with `instabox feedback`. On Discord, your posts in the help forums are listed once you link your Discord account on the Profile page. Reply to those in their Discord thread. ![The Support page with the account menu open on Support, listing tickets from the Dashboard, Discord and the CLI, each with its status and last activity](https://instabox.sh/changelog/images/2026-10-26-support-center/support-tickets.webp) ## Secrets https://instabox.sh/changelog/secrets.md 2026-10-24 · Security, Dashboard, CLI, API InstaBox now stores API keys as encrypted Secrets and adds them to outgoing HTTPS request headers. Your sandbox uses a placeholder instead of the real key. Create a Secret on the dashboard's Secrets page. New sandboxes created in the dashboard use all Secrets in their workspace. Existing sandboxes keep their selections. Or save a Secret and select it when you create a sandbox with the CLI. The value is read from a prompt without echo: ``` instabox secrets set OPENAI_API_KEY --host api.openai.com instabox create --name app --secrets all ``` Inside the sandbox, `OPENAI_API_KEY` holds a placeholder. Use it in an HTTPS request header, such as `Authorization: Bearer $OPENAI_API_KEY`. The outbound proxy replaces the placeholder with the real key when the request goes to an allowed host. Set allowed hosts to exact hostnames, or use `*` to allow any public HTTPS destination. Proxy delivery covers HTTPS on port 443 and replaces placeholders in headers only, not in the URL or body. See [Secrets](https://instabox.sh/docs/secrets.md). ![The Add Secret dialog with Name, Allowed hosts, and Value fields](https://instabox.sh/changelog/images/2026-10-24-secrets/add-secret.webp) ## Plans and billing https://instabox.sh/changelog/plans-and-billing.md 2026-10-20 · Billing, Dashboard, CLI InstaBox now has plans. Free gives you one 4 vCPU / 8 GiB machine to run every month at no cost, and Pro, Team and Enterprise are for commercial use. Pro is $20 a month and Team is $500 a month. Each includes usage equal to its fee, and usage beyond that is pay as you go. On a paid plan every machine counts toward the plan's limit and is billed by usage. Enterprise has custom pricing: [contact us](https://instabox.sh/contact). Subscribe with a card on the Billing page in the dashboard. Unit prices and a cost calculator are on [Pricing](https://instabox.sh/pricing). | | Free | Pro | Team | | ---------- | ------------------------ | --------------------- | ---------------------- | | Machines | 1, never billed | 5, all billed | Unlimited, 100 at once | | Sizes | 2 vCPU / 4 GiB, 4 / 8 | 2 / 4, 4 / 8, 8 / 16 | 4 / 8 up to 32 / 64 | | Templates | standard (agent-browser) | All | All | | Snapshots | 5 | Unlimited | Unlimited | | Auto-pause | After 30 idle minutes | Your choice, or never | Your choice, or never | Pick a size in the create dialog, or on the command line. Without one, a machine gets the default, 4 vCPU / 8 GiB. `instabox whoami --json` lists your plan's sizes as `allowedSpecs`. On Free or Pro, a small machine is: ``` instabox create --vcpus 2 --mem-mib 4096 ``` Accounts activated before October 20 keep five free machines until December 1. ![The pricing page: Free at $0, Pro at $20 a month, Team at $500 a month and Enterprise at a custom price, each with what it includes](https://instabox.sh/changelog/images/2026-10-20-plans-and-billing/pricing.webp) ## Blog and Changelog for InstaBox https://instabox.sh/changelog/changelog-and-blog.md 2026-10-19 · Docs InstaBox now has a changelog for every change and a blog for launches and engineering notes. You can filter the changelog by category to find the changes you care about. Tell us what you want next on [Discord](https://discord.gg/instabox). ![This entry's own page: its title, its date and Docs category, its summary and its text](https://instabox.sh/changelog/images/2026-10-19-changelog-and-blog/changelog-entry.webp)