Install the Darkbloom Sandbox add-on, approve the Mac, choose work disks, size the build cache, and schedule, update or remove the add-on.
This page takes a Mac that already meets the hosting requirements and makes it a Darkbloom Sandbox host. Setup installs the add-on in ~/DarkbloomSandbox, enrolls the Mac, and downloads the VM images in the background.
1
Install the add-on
With the Darkbloom provider CLI, update to 0.10.5 or later, then run setup:
darkbloom updatedarkbloom sandbox setup
Setup checks the Mac and asks before it changes anything. Without the CLI, run the add-on’s installer directly:
curl -fsSL https://api-sandbox.darkbloom.dev/install.sh | sh
Setup refuses sudo. Run it as your own user, logged in at the desktop.Arguments go to the installer after sh -s --. For example:
curl -fsSL https://api-sandbox.darkbloom.dev/install.sh | sh -s -- --macos-slots 1
2
Read the plan
Setup prints the cores, memory and disk it counted, how many Linux and macOS jobs the Mac can run at a time, and what limited them. With darkbloom sandbox setup, nothing is installed until you answer y.To see the plan without installing anything:
curl -fsSL https://api-sandbox.darkbloom.dev/install.sh | sh -s -- --plan
If no job fits, setup says how much disk one Linux job and one macOS job would need, and stops.
3
Approve the Mac
The installer opens the console’s device page with the Mac’s code filled in, and prints the link and code as well. Sign in with the Darkbloom account that should receive the earnings, check that the Mac and code are yours, and press Approve this Mac.
The enrollment request page in the sandbox console: check the code and the Mac, then approve it. Example data.
Approve within 15 minutes, or the code expires and you run setup again for a new one. In add-on releases after 1.3.3, the installer also shows the time the code expires. Add --no-browser to print the link without opening a browser.If the account is not approved yet, the request joins a waitlist and the Mac waits; see waitlist and approval. From add-on 1.2.0 you can close the setup window, and the Mac keeps waiting across restarts and macOS updates.If the Mac hosted before, its code replaces the old host. The installer says which, and the approval page asks you to confirm the replacement: tick I am re-enrolling …, then Approve & replace.
4
Let the images download
After enrollment the agent starts, and the Mac downloads its VM images in the background: about 3 GB for Linux and 45 GB for macOS. On a Mac that runs only Linux jobs, that is the 3 GB. At 100 Mbps the macOS image takes about an hour.The Mac takes jobs once an image is installed. Add --wait-ready to setup to keep it open until then, or follow the download with darkbloom sandbox status. Getting no job in the first hour is normal.
What the plan counts
The installer sizes the slots from the Mac’s cores, memory and free disk. It prints the slots it chose and what limited them.
The owner keeps a quarter of the cores (at least 2) and a quarter of the memory (at least 8 GB). If the inference provider runs, it keeps another quarter of the memory.
A slot takes the smaller runner class of its platform: Linux 4 cores and 16 GB, macOS 8 cores and 16 GB.
Slots go out Linux, macOS, Linux, macOS, then Linux, while cores, memory and disk last.
macOS has at most 2 slots, the kernel’s limit, which counts your own macOS VMs too. Linux has at most 16.
Disk gives each Linux slot its job’s 30 GiB scratch disk, each macOS slot its job’s 40 GiB write budget, and the first slot of a platform its images (4 GiB for Linux, 46 GiB for macOS) unless they are already installed.
Mac, with enough free disk
Linux slots
macOS slots
8 cores, 16 GB
0 (the installer refuses)
0
12 cores, 32 GB
1
0
16 cores, 48 GB
1
1 (0 with the inference provider)
16 cores, 128 GB
1
1
24 cores, 192 GB
2
1
32 cores, 512 GB
2
2
Slots are counted at the smaller VM size. Darkbloom places each job by the cores, memory and disk the Mac reports free at that moment, so a larger job needs more room.The plan names what stopped the hand-out from giving a platform another slot: free disk space, cores, memory, the 16-slot maximum, macOS's limit of 2 VMs, yours included, or your choice when you set the count.
Choose the number of slots
Ask for fewer jobs with --linux-slots and --macos-slots. Linux takes 0 to 16 and macOS 0 to 2; both 0 is refused.
--macos-slots 1 keeps one of macOS’s two macOS VMs for your own use.
--macos-slots 0 keeps both.
--linux-slots 0 gives macOS the whole disk.
Running setup again recomputes the slots, so give your options again each time. A rerun keeps the enrollment, rewrites agent.json, and restarts the agent only if something changed. Rerunning is always safe: if anything fails, the installer puts back what ran before, and it never moves a Mac to an older release.
Disk budget
The add-on keeps its images and jobs in ~/DarkbloomSandbox, on the disk that holds your home folder, or on the work disks you give it.
Floor. Darkbloom keeps a floor of free space: a tenth of the disk, at least 50 GiB and at most 100 GiB (54 to 107 GB). No job starts, and no image downloads, if that could push free space below the floor.
Images. About 3 GB for Linux and 45 GB for macOS. A Mac downloads only the images of the jobs it runs. They download at setup and again when Darkbloom updates an image, and for a while both copies stay on the disk. Most macOS updates (the GitHub runner, Darkbloom’s own guest software) replace only a 0.5 GB part of the macOS image; a new macOS or Xcode version replaces the 45 GB disk.
Linux jobs. Each Linux slot needs 30 GiB (32 GB) above the floor for its job’s scratch disk, also while images download.
macOS jobs. Each macOS slot needs 40 GiB (43 GB) above the floor, the most a macOS job is expected to write, also while images download. That room is all a macOS job needs to start: its VM’s disk is 150 GiB (161 GB), but takes only what the job writes.
Guard. If free space still falls below the floor while jobs run, the add-on stops the running jobs within about 10 seconds and deletes what they wrote. Darkbloom runs those jobs elsewhere.
Agent sandbox images. With agent sandboxes on, the Linux sandbox image takes 10 GiB, which the installer keeps room for. On Macs that run macOS jobs the macOS one takes about 46 GiB: that image downloads only into the space left beyond the floor, the slots’ room and your CI images, and the Mac offers macOS sandboxes once it is in.
When it sizes the slots, the installer counts for the first slot of each kind its images too, rounded up (4 GiB for Linux, 46 GiB for macOS), unless they are already on the Mac. A job uses only the space it writes and frees it when it ends.For example, a 2 TB disk keeps a floor of 100 GiB (107 GB). With 157 GiB (169 GB) free before you install, a Mac gets one Linux slot and a 23 GiB build cache. With 220 GiB (236 GB) free, it gets a Linux and a macOS slot if its cores and memory allow, and no build cache until about 8 GiB more is free.If free space falls after you install and an image no longer fits, that image waits and the others still download, so their slots take jobs. status names the image and how much space to free, or run the installer again to fit the slots to the space you have.
Work disks
If the internal disk is what limits the Mac, give the images and jobs one or more other disks. The add-on itself, its settings and logs stay in ~/DarkbloomSandbox.
Use a fast drive: a Thunderbolt or USB4 NVMe SSD. Every job reads its VM image and writes its scratch disk there, and a macOS image is 45 GB, so a spinning disk, a USB-A flash drive or a network share makes every job slow (network shares are refused). Use a drive the Mac keeps powered and connected. A job running on a drive that goes away is stopped and run elsewhere, unpaid.
Format it as APFS in Disk Utility. ExFAT, FAT and Mac OS Extended (HFS+) drives are refused, and so is a disk image: its space is the disk that holds its file.
Turn on ownership, which macOS leaves off for external drives:
sudo diskutil enableOwnership /Volumes/FastSSD
Give the drive to the installer. Repeat --disk for more drives, and add --disk ~ to keep using the internal disk too:
darkbloom sandbox setup --disk /Volumes/FastSSD
Setup checks each drive before it installs anything. When ownership is off, it prints the command and offers to run it. Add --plan first to see what each disk would get.
Each disk keeps its own floor of free space (a tenth of the disk, 50 to 100 GiB) and holds the images of the jobs it runs: Darkbloom downloads an image once and copies it to the other disks that need it. The add-on uses a folder named DarkbloomSandbox at the top of each drive and nothing else on it.If you unplug a drive, its slots stop taking jobs and nothing is written in its place. Plug it back in and they take jobs again once the add-on has checked the images on it. A drive that mounts after you log in is used as soon as it appears. status shows each disk, its free space and its slots.
An ExFAT drive
To keep an ExFAT drive’s files, let the add-on make one encrypted disk image on it (a single file at its top; nothing is erased), and give that disk to the installer:
It prints the --disk to give. Its key stays on this Mac, and uninstall needs --delete-managed-disks to delete it with the install.
Build cache
From add-on 1.2.1 your Mac keeps a build cache for the jobs it runs, on by default. A job restores its dependencies and build outputs from your disk instead of downloading them over your connection, and saves them there for the next job.
It takes up to 32 GiB on a 1 TB disk (16 GiB on 512 GB, 8 GiB on smaller ones), and only what the slots leave: never the floor, never a slot’s room.
With less than 8 GiB left, it stays off, and status says how much to free.
It gives way to jobs and images at once, deleting its oldest entries.
What it holds is encrypted inside the VM before it reaches your disk.
To size it or turn it off, run the installer with --cache-size 16 (GiB) or --no-cache. Without either, an earlier install’s size stays; a new install uses the default for its disk.
curl -fsSL https://api-sandbox.darkbloom.dev/install.sh | sh -s -- --cache-size 16curl -fsSL https://api-sandbox.darkbloom.dev/install.sh | sh -s -- --no-cache
Scheduling and pause
To stop taking new work for a while:
darkbloom sandbox pausedarkbloom sandbox resume
No new job starts, and no agent sandbox starts or resumes on the Mac; jobs already running finish and are paid. The Mac stays paused after restarts and updates, and the console shows it as Paused by owner. You do not need to sign in. Without the CLI, use ~/DarkbloomSandbox/darkbloom-sandbox pause and resume.To take jobs only in the hours you choose, set a weekly schedule in the Mac’s local time:
~/DarkbloomSandbox/darkbloom-sandbox schedule set 'mon-fri 22:00-07:00' 'weekends 00:00-24:00'~/DarkbloomSandbox/darkbloom-sandbox schedule~/DarkbloomSandbox/darkbloom-sandbox schedule off
Days are mon … sun, ranges such as mon-fri, or daily, weekdays, weekends; an end before the start runs past midnight. Outside every window no new job starts; a job still running when a window ends finishes. status and the console show Paused by schedule until the next window.
Agent sandboxes
Agent sandboxes are on by default from add-on 1.3.0. Their workspaces live in the same store as the build cache, with their own allowance: 96 GiB by default, set with the installer’s --workspace-size. Each workspace takes its disk’s room when it is created, and the room it may still grow into is kept beside CI jobs.To turn agent sandboxes off, run the installer again with --no-agent-sessions. Later installs and updates keep them off, and CI jobs do not change.
curl -fsSL https://api-sandbox.darkbloom.dev/install.sh | sh -s -- --no-agent-sessions
To stop new work only for a while, use pause or a schedule. They stop new CI jobs and new sandboxes alike.
Updates
Updates are automatic. When Darkbloom approves a new release, the agent hears about it over its connection and checks within about two minutes; otherwise it checks every five minutes. (Add-on 1.2.0 and earlier check every hour.) Darkbloom may approve a release for some Macs before others.The agent installs a release only if all of these hold:
The app is signed with Darkbloom’s Apple Developer ID, and the release is signed with Darkbloom’s release key, which the installed app pins.
The release is newer than the running version and supports your macOS version.
Darkbloom’s servers already accept that build for your Mac.
The agent then stops taking jobs and waits for the running ones to finish. After that it swaps the app and restarts. You do not need to enroll again. If the new version does not connect to Darkbloom within three starts, or Darkbloom refuses it, the agent goes back to the previous version and skips the new one from then on. status shows the last check.
Uninstall
Pause first and wait until status shows no job running: uninstalling stops the agent and any running job, and a stopped job is not paid.
darkbloom sandbox uninstall
The add-on’s own command is ~/DarkbloomSandbox/darkbloom-sandbox uninstall. It removes ~/DarkbloomSandbox (the app, images and state, except the workspaces it keeps), each work disk’s DarkbloomSandbox folder (only while that disk is mounted; it says which stays), and the LaunchAgent.Uninstalling keeps the agent sandbox workspaces the Mac stores (add-on releases after 1.3.8). A workspace holds the files of someone’s sandbox, stopped or running. It exists on your Mac alone, so deleting it cannot be undone. uninstall prints how many it kept, how much disk they use and where they are:
==> Kept 2 agent sandbox workspaces of 2 sandboxes (64 GiB reserved, 12.4 GiB used) in ~/DarkbloomSandbox/agent/state/storage; to delete them: rm -rf /Users/you/DarkbloomSandbox/agent/state/storage
The disk space printed as used is what they cost you. If you set the Mac up again the same way (the same disks), it finds them, and until you delete them they count against its workspace allowance, so it takes fewer new sandboxes. The room they may still grow into is also kept from its CI jobs, so it may take fewer CI jobs too.
Today no sandbox can resume from a kept workspace, not even on this Mac set up again: Darkbloom sees that Mac as a new one. Keeping the workspace is what will let it resume once Darkbloom supports that. Darkbloom ends a sandbox that stays stopped for 30 days; after that its workspace is of no use to anyone, and nothing deletes it for you yet.
To delete them as you uninstall, add --delete-workspaces. --yes alone never deletes them.
After an uninstall, the Mac stays registered to your account but gets no work. To revoke it, remove it in the console: Macs, then the Mac, then Remove Mac. A removed Mac’s sandboxes can never resume. The Mac’s keychain keeps which host it was, so setting it up again replaces that host instead of adding a second one; you confirm the replacement when you approve the code. To make the Mac forget it, add --forget:
For a Mac that is no longer enrolled and fails to approve a replacement code, see check your Mac’s status.
Was this page helpful?
⌘I
{"docsConfig":{"theme":"maple","$schema":"https://mintlify.com/docs.json","name":"Darkbloom","colors":{"primary":"#0B44FF","light":"#0B44FF","dark":"#00159E"},"logo":{"light":"https://mintcdn.com/eigenlabs-f49d2e97/IspAEDzrILVDDfNo/images/Blacklogo.png?fit=max\u0026auto=format\u0026n=IspAEDzrILVDDfNo\u0026q=85\u0026s=0b259f057d233a45818dfca27115accb","dark":"https://mintcdn.com/eigenlabs-f49d2e97/IspAEDzrILVDDfNo/images/Whitelogo.png?fit=max\u0026auto=format\u0026n=IspAEDzrILVDDfNo\u0026q=85\u0026s=18a35652c459889ced623c18f01917bd"},"favicon":{"light":"https://mintcdn.com/eigenlabs-f49d2e97/--BbdTF42cwZojzK/images/favicon.png?fit=max\u0026auto=format\u0026n=--BbdTF42cwZojzK\u0026q=85\u0026s=4d67d819d9b9cbde6cc1387d28d3a0a3","dark":"https://mintcdn.com/eigenlabs-f49d2e97/--BbdTF42cwZojzK/images/favicon.png?fit=max\u0026auto=format\u0026n=--BbdTF42cwZojzK\u0026q=85\u0026s=4d67d819d9b9cbde6cc1387d28d3a0a3"},"navbar":{"links":[{"href":"/get-started/pricing-overview","label":"Pricing"}],"primary":{"type":"github","href":"https://github.com/Layr-Labs/d-inference"}},"fonts":{"heading":{"family":"Montserrat"},"body":{"family":"Poppins","weight":400}},"icons":{"library":"fontawesome"},"styling":{"latex":true},"navigation":{"pages":[]}},"deployment":{"deploymentMetadataValue":{"subdomain":"eigenlabs-f49d2e97","hasAudioNarration":false,"actualSubdomain":"eigenlabs-f49d2e97","customDomains":["docs.darkbloom.dev"],"gitSource":{"type":"github","owner":"layr-labs","repo":"darkbloom-docs","deployBranch":"master","contentDirectory":"","isPrivate":true,"mountPath":"","label":""},"feedback":{"thumbs":true},"entitlements":{"AI_CHAT":{"status":"ENABLED"},"WEB_MCP":{"status":"ENABLED"},"NARRATION":{"status":"ENABLED"}},"buildId":"6afb65a4d05d4846e1f78bcc","clientVersion":"0.0.4271","searchFilterCounts":[{"language":"default","tag":"Get started","count":18},{"language":"default","tag":"Sandboxes","count":11},{"language":"default","tag":"Inference","count":10},{"language":"default","tag":"Providers","count":10},{"language":"default","tag":"CI","count":9},{"language":"default","tag":"API Reference","count":9},{"language":"default","tag":"Guides","count":7},{"language":"default","tag":"Reference","count":7},{"language":"default","tag":"Start here","count":4},{"language":"default","tag":"Serve inference","count":4}]},"assistantConfig":{"enableAskAiButton":false,"enableStarterQuestions":false,"enableContextualStarterQuestions":false,"enableAskAiSearchBar":true},"basePath":"","hasChatPermissions":true,"hasWebMcpPermissions":true,"toggles":[{"name":"kill-isr","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-rbac-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-mintlify-slack","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"agent-integrations-settings","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"rbac-expansion","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-pr-grouping","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"custom-prefix","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"analytics-v7","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"user-flows-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"no-publish-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-onboarding","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving-live","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"stripTemperatureMiddleware","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"support-platform-pylon-zendesk","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"snapshot-serving","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"instant-rollback","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications-server","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"granular-notifications","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automations-fable","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fixed-ai-action-pricing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"site-roles","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"automation-resolve-merge-conflict","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"scoped-publishing","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"mintql","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"page-level-analytics","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-version-history-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"billing-page-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"full-page-search","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workspace-projects","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"assistant-v5","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"fork-pr-previews","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"revalidation-jwt","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-sso-scim","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"hobby-abuse-scan","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"dashboard-inbox","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-signup","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-dual-write","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"workos-enabled","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"approve-review-flow","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"editor-metadata","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"sso-setup-deadline-banner","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"turbopuffer-serve","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"live-agents","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"starter-pricing","enabled":true,"variant":{"name":"control","enabled":true,"payload":{"type":"string","value":"control"},"feature_enabled":true},"impressionData":false},{"name":"llms-txt-v2","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false},{"name":"wildcard-email-auth","enabled":true,"variant":{"name":"disabled","enabled":false,"feature_enabled":true},"impressionData":false}],"googleFontsInlined":true},"customCss":[{"filePath":"custom.css","content":"@font-face{font-family:\"PP Telegraf\";src:url(\"/fonts/PPTelegraf-Semibold.woff\") format(\"woff\");font-weight:600;font-style:normal;font-display:swap}@font-face{font-family:\"PP Telegraf\";src:url(\"/fonts/PPTelegraf-Regular.woff2\") format(\"woff2\");font-weight:400;font-style:normal;font-display:swap}@font-face{font-family:\"ABC Repro Variable\";src:url(\"/fonts/ABCReproVariable.woff\") format(\"woff\");font-weight:100 900;font-style:normal;font-display:swap}:root{--rounded-sm: 0.125rem;--rounded: 0.25rem;--rounded-md: 0.25rem;--rounded-lg: 0.375rem;--rounded-xl: 0.375rem;--rounded-xt: 0.375rem;--rounded-2xl: 0.5rem;--rounded-3xl: 0.75rem;--rounded-search: 0.5rem}img.nav-logo{height:clamp(0.75rem, 1.2vw, 1.25rem)!important;width:auto}h1,h2,h3,h4,h5,h6,.prose h1,.prose h2,.prose h3,.prose h4,.prose h5,.prose h6{font-family:\"PP Telegraf\", sans-serif;font-weight:600}.prose p,.prose li,.prose td,.prose th,.prose blockquote{font-family:\"ABC Repro Variable\", sans-serif;font-size:clamp(0.875rem, 1.5vw, 0.9375rem);line-height:1.75}#sidebar{z-index:35!important}[data-theme-preference-switch=\"pill\"]{position:fixed!important;top:0.875rem;right:1.5rem;z-index:2147483647!important;transform:translateZ(0)}html.dark{--background-dark: 0 0 0}.prose pre,[data-component-part=\"code-block-root\"],[data-component-part=\"code-block-header\"]{border-radius:0.375rem!important}.prose code{border-radius:0.25rem}"}]}
{"page":{"pagePath":"provider/sandbox-setup","slug":"/provider/sandbox-setup","pageMetadata":{"title":"Set up your Mac to host sandboxes","description":"Install the Darkbloom Sandbox add-on, approve the Mac, choose work disks, size the build cache, and schedule, update or remove the add-on.","href":"/provider/sandbox-setup"},"description":{"compiledSource":"\"use strict\";\nconst {jsx: _jsx} = arguments[0];\nconst {useMDXComponents: _provideComponents} = arguments[0];\nfunction _createMdxContent(props) {\n const _components = {\n p: \"p\",\n ..._provideComponents(),\n ...props.components\n };\n return _jsx(_components.p, {\n children: \"Install the Darkbloom Sandbox add-on, approve the Mac, choose work disks, size the build cache, and schedule, update or remove the add-on.\"\n });\n}\nfunction MDXContent(props = {}) {\n const {wrapper: MDXLayout} = {\n ..._provideComponents(),\n ...props.components\n };\n return MDXLayout ? _jsx(MDXLayout, {\n ...props,\n children: _jsx(_createMdxContent, {\n ...props\n })\n }) : _createMdxContent(props);\n}\nreturn {\n default: MDXContent\n};\n","frontmatter":{},"scope":{}},"pageType":"default","mdx":{"mdxSource":{"compiledSource":"\"use strict\";const{Fragment:_Fragment,jsx:_jsx,jsxs:_jsxs}=arguments[0];const{useMDXComponents:_provideComponents}=arguments[0];function _createMdxContent(props){const _components={a:`a`,code:`code`,li:`li`,ol:`ol`,p:`p`,pre:`pre`,span:`span`,strong:`strong`,tbody:`tbody`,td:`td`,th:`th`,thead:`thead`,tr:`tr`,ul:`ul`,..._provideComponents(),...props.components},{CodeBlock,Frame,Heading,OptimizedImage,Step,Steps,Table}=_components;if(!CodeBlock)_missingMdxReference(`CodeBlock`,true);if(!Frame)_missingMdxReference(`Frame`,true);if(!Heading)_missingMdxReference(`Heading`,true);if(!OptimizedImage)_missingMdxReference(`OptimizedImage`,true);if(!Step)_missingMdxReference(`Step`,true);if(!Steps)_missingMdxReference(`Steps`,true);if(!Table)_missingMdxReference(`Table`,true);return _jsxs(_Fragment,{children:[_jsxs(_components.p,{children:[`This page takes a Mac that already meets the `,_jsx(_components.a,{href:`/provider/sandbox-hosting#what-you-need`,children:`hosting requirements`}),` and makes it a Darkbloom Sandbox host. Setup installs the add-on in `,_jsx(_components.code,{children:`~/DarkbloomSandbox`}),`, enrolls the Mac, and downloads the VM images in the background.`]}),`\n`,_jsxs(Steps,{children:[_jsxs(Step,{title:`Install the add-on`,children:[_jsx(_components.p,{children:`With the Darkbloom provider CLI, update to 0.10.5 or later, then run setup:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`darkbloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` update`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`darkbloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` setup`})]}),`\n`]})})}),_jsx(_components.p,{children:`Setup checks the Mac and asks before it changes anything. Without the CLI, run the add-on’s installer directly:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api-sandbox.darkbloom.dev/install.sh`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` sh`})]}),`\n`]})})}),_jsxs(_components.p,{children:[`Setup refuses `,_jsx(_components.code,{children:`sudo`}),`. Run it as your own user, logged in at the desktop.`]}),_jsxs(_components.p,{children:[`Arguments go to the installer after `,_jsx(_components.code,{children:`sh -s --`}),`. For example:`]}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api-sandbox.darkbloom.dev/install.sh`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` sh`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --macos-slots`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1`})]}),`\n`]})})})]}),_jsxs(Step,{title:`Read the plan`,children:[_jsxs(_components.p,{children:[`Setup prints the cores, memory and disk it counted, how many Linux and macOS jobs the Mac can run at a time, and what limited them. With `,_jsx(_components.code,{children:`darkbloom sandbox setup`}),`, nothing is installed until you answer `,_jsx(_components.code,{children:`y`}),`.`]}),_jsx(_components.p,{children:`To see the plan without installing anything:`}),_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api-sandbox.darkbloom.dev/install.sh`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` sh`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --plan`})]}),`\n`]})})}),_jsx(_components.p,{children:`If no job fits, setup says how much disk one Linux job and one macOS job would need, and stops.`})]}),_jsxs(Step,{title:`Approve the Mac`,children:[_jsxs(_components.p,{children:[`The installer opens the console’s device page with the Mac’s code filled in, and prints the link and code as well. Sign in with the Darkbloom account that should receive the earnings, check that the Mac and code are yours, and press `,_jsx(_components.strong,{children:`Approve this Mac`}),`.`]}),_jsx(Frame,{caption:`The enrollment request page in the sandbox console: check the code and the Mac, then approve it. Example data.`,children:_jsx(OptimizedImage,{src:`https://mintcdn.com/eigenlabs-f49d2e97/2TtlNanikOmTAJr5/images/console/device-approve.png?fit=max\u0026auto=format\u0026n=2TtlNanikOmTAJr5\u0026q=85\u0026s=df6a18490d89564a991ba7a10b69b00e`,alt:`Sandbox console enrollment request page showing the code, the Mac's model and add-on version, and what approving does`,\"data-og-width\":`1800`,width:`1800`,\"data-og-height\":`1125`,height:`1125`,\"data-path\":`images/console/device-approve.png`,\"data-optimize\":`true`,\"data-opv\":`3`,srcset:`https://mintcdn.com/eigenlabs-f49d2e97/2TtlNanikOmTAJr5/images/console/device-approve.png?w=280\u0026fit=max\u0026auto=format\u0026n=2TtlNanikOmTAJr5\u0026q=85\u0026s=686a3d5e68d2aad70de8a95d56108160 280w, https://mintcdn.com/eigenlabs-f49d2e97/2TtlNanikOmTAJr5/images/console/device-approve.png?w=560\u0026fit=max\u0026auto=format\u0026n=2TtlNanikOmTAJr5\u0026q=85\u0026s=3b2785fc97fabd7d2226053dc3a609f3 560w, https://mintcdn.com/eigenlabs-f49d2e97/2TtlNanikOmTAJr5/images/console/device-approve.png?w=840\u0026fit=max\u0026auto=format\u0026n=2TtlNanikOmTAJr5\u0026q=85\u0026s=b3c85750b260a1cbc0e5d7b6674501ba 840w, https://mintcdn.com/eigenlabs-f49d2e97/2TtlNanikOmTAJr5/images/console/device-approve.png?w=1100\u0026fit=max\u0026auto=format\u0026n=2TtlNanikOmTAJr5\u0026q=85\u0026s=3eaa2e2e8cb204038eada48dad9a13f9 1100w, https://mintcdn.com/eigenlabs-f49d2e97/2TtlNanikOmTAJr5/images/console/device-approve.png?w=1650\u0026fit=max\u0026auto=format\u0026n=2TtlNanikOmTAJr5\u0026q=85\u0026s=d4c700091c17fcdb78e199691dea30c0 1650w, https://mintcdn.com/eigenlabs-f49d2e97/2TtlNanikOmTAJr5/images/console/device-approve.png?w=2500\u0026fit=max\u0026auto=format\u0026n=2TtlNanikOmTAJr5\u0026q=85\u0026s=dd85a7e823697dfe9cfcd57fa9386f6c 2500w`})}),_jsxs(_components.p,{children:[`Approve within 15 minutes, or the code expires and you run setup again for a new one. In add-on releases after 1.3.3, the installer also shows the time the code expires. Add `,_jsx(_components.code,{children:`--no-browser`}),` to print the link without opening a browser.`]}),_jsxs(_components.p,{children:[`If the account is not approved yet, the request joins a waitlist and the Mac waits; see `,_jsx(_components.a,{href:`/provider/sandbox-hosting#waitlist-and-approval`,children:`waitlist and approval`}),`. From add-on 1.2.0 you can close the setup window, and the Mac keeps waiting across restarts and macOS updates.`]}),_jsxs(_components.p,{children:[`If the Mac hosted before, its code replaces the old host. The installer says which, and the approval page asks you to confirm the replacement: tick `,_jsx(_components.strong,{children:`I am re-enrolling …`}),`, then `,_jsx(_components.strong,{children:`Approve \u0026 replace`}),`.`]})]}),_jsxs(Step,{title:`Let the images download`,children:[_jsx(_components.p,{children:`After enrollment the agent starts, and the Mac downloads its VM images in the background: about 3 GB for Linux and 45 GB for macOS. On a Mac that runs only Linux jobs, that is the 3 GB. At 100 Mbps the macOS image takes about an hour.`}),_jsxs(_components.p,{children:[`The Mac takes jobs once an image is installed. Add `,_jsx(_components.code,{children:`--wait-ready`}),` to setup to keep it open until then, or follow the download with `,_jsx(_components.code,{children:`darkbloom sandbox status`}),`. Getting no job in the first hour is normal.`]})]})]}),`\n`,_jsx(Heading,{level:`2`,id:`what-the-plan-counts`,children:`What the plan counts`}),`\n`,_jsx(_components.p,{children:`The installer sizes the slots from the Mac’s cores, memory and free disk. It prints the slots it chose and what limited them.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The owner keeps a quarter of the cores (at least 2) and a quarter of the memory (at least 8 GB). If the inference provider runs, it keeps another quarter of the memory.`}),`\n`,_jsx(_components.li,{children:`A slot takes the smaller runner class of its platform: Linux 4 cores and 16 GB, macOS 8 cores and 16 GB.`}),`\n`,_jsx(_components.li,{children:`Slots go out Linux, macOS, Linux, macOS, then Linux, while cores, memory and disk last.`}),`\n`,_jsx(_components.li,{children:`macOS has at most 2 slots, the kernel’s limit, which counts your own macOS VMs too. Linux has at most 16.`}),`\n`,_jsx(_components.li,{children:`Disk gives each Linux slot its job’s 30 GiB scratch disk, each macOS slot its job’s 40 GiB write budget, and the first slot of a platform its images (4 GiB for Linux, 46 GiB for macOS) unless they are already installed.`}),`\n`]}),`\n`,_jsxs(Table,{children:[_jsx(_components.thead,{children:_jsxs(_components.tr,{children:[_jsx(_components.th,{children:`Mac, with enough free disk`}),_jsx(_components.th,{children:`Linux slots`}),_jsx(_components.th,{children:`macOS slots`})]})}),_jsxs(_components.tbody,{children:[_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`8 cores, 16 GB`}),_jsx(_components.td,{children:`0 (the installer refuses)`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`12 cores, 32 GB`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`0`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`16 cores, 48 GB`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1`}),_jsx(_components.td,{children:`1 (0 with the inference provider)`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`16 cores, 128 GB`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`24 cores, 192 GB`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`1`})]}),_jsxs(_components.tr,{children:[_jsx(_components.td,{children:`32 cores, 512 GB`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2`}),_jsx(_components.td,{\"data-numeric\":`true`,children:`2`})]})]})]}),`\n`,_jsx(_components.p,{children:`Slots are counted at the smaller VM size. Darkbloom places each job by the cores, memory and disk the Mac reports free at that moment, so a larger job needs more room.`}),`\n`,_jsxs(_components.p,{children:[`The plan names what stopped the hand-out from giving a platform another slot: `,_jsx(_components.code,{children:`free disk space`}),`, `,_jsx(_components.code,{children:`cores`}),`, `,_jsx(_components.code,{children:`memory`}),`, `,_jsx(_components.code,{children:`the 16-slot maximum`}),`, `,_jsx(_components.code,{children:`macOS's limit of 2 VMs, yours included`}),`, or `,_jsx(_components.code,{children:`your choice`}),` when you set the count.`]}),`\n`,_jsx(Heading,{level:`3`,id:`choose-the-number-of-slots`,children:`Choose the number of slots`}),`\n`,_jsxs(_components.p,{children:[`Ask for fewer jobs with `,_jsx(_components.code,{children:`--linux-slots`}),` and `,_jsx(_components.code,{children:`--macos-slots`}),`. Linux takes 0 to 16 and macOS 0 to 2; both 0 is refused.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`darkbloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` setup`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --linux-slots`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 2`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`darkbloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` setup`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --macos-slots`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 1`})]}),`\n`]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`--macos-slots 1`}),` keeps one of macOS’s two macOS VMs for your own use.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`--macos-slots 0`}),` keeps both.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.code,{children:`--linux-slots 0`}),` gives macOS the whole disk.`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Running setup again recomputes the slots, so give your options again each time. A rerun keeps the enrollment, rewrites `,_jsx(_components.code,{children:`agent.json`}),`, and restarts the agent only if something changed. Rerunning is always safe: if anything fails, the installer puts back what ran before, and it never moves a Mac to an older release.`]}),`\n`,_jsx(Heading,{level:`2`,id:`disk-budget`,children:`Disk budget`}),`\n`,_jsxs(_components.p,{children:[`The add-on keeps its images and jobs in `,_jsx(_components.code,{children:`~/DarkbloomSandbox`}),`, on the disk that holds your home folder, or on the work disks you give it.`]}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Floor.`}),` Darkbloom keeps a floor of free space: a tenth of the disk, at least 50 GiB and at most 100 GiB (54 to 107 GB). No job starts, and no image downloads, if that could push free space below the floor.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Images.`}),` About 3 GB for Linux and 45 GB for macOS. A Mac downloads only the images of the jobs it runs. They download at setup and again when Darkbloom updates an image, and for a while both copies stay on the disk. Most macOS updates (the GitHub runner, Darkbloom’s own guest software) replace only a 0.5 GB part of the macOS image; a new macOS or Xcode version replaces the 45 GB disk.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Linux jobs.`}),` Each Linux slot needs 30 GiB (32 GB) above the floor for its job’s scratch disk, also while images download.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`macOS jobs.`}),` Each macOS slot needs 40 GiB (43 GB) above the floor, the most a macOS job is expected to write, also while images download. That room is all a macOS job needs to start: its VM’s disk is 150 GiB (161 GB), but takes only what the job writes.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Guard.`}),` If free space still falls below the floor while jobs run, the add-on stops the running jobs within about 10 seconds and deletes what they wrote. Darkbloom runs those jobs elsewhere.`]}),`\n`,_jsxs(_components.li,{children:[_jsx(_components.strong,{children:`Agent sandbox images.`}),` With agent sandboxes on, the Linux sandbox image takes 10 GiB, which the installer keeps room for. On Macs that run macOS jobs the macOS one takes about 46 GiB: that image downloads only into the space left beyond the floor, the slots’ room and your CI images, and the Mac offers macOS sandboxes once it is in.`]}),`\n`]}),`\n`,_jsx(_components.p,{children:`When it sizes the slots, the installer counts for the first slot of each kind its images too, rounded up (4 GiB for Linux, 46 GiB for macOS), unless they are already on the Mac. A job uses only the space it writes and frees it when it ends.`}),`\n`,_jsx(_components.p,{children:`For example, a 2 TB disk keeps a floor of 100 GiB (107 GB). With 157 GiB (169 GB) free before you install, a Mac gets one Linux slot and a 23 GiB build cache. With 220 GiB (236 GB) free, it gets a Linux and a macOS slot if its cores and memory allow, and no build cache until about 8 GiB more is free.`}),`\n`,_jsxs(_components.p,{children:[`If free space falls after you install and an image no longer fits, that image waits and the others still download, so their slots take jobs. `,_jsx(_components.code,{children:`status`}),` names the image and how much space to free, or run the installer again to fit the slots to the space you have.`]}),`\n`,_jsx(Heading,{level:`2`,id:`work-disks`,children:`Work disks`}),`\n`,_jsxs(_components.p,{children:[`If the internal disk is what limits the Mac, give the images and jobs one or more other disks. The add-on itself, its settings and logs stay in `,_jsx(_components.code,{children:`~/DarkbloomSandbox`}),`.`]}),`\n`,_jsxs(_components.ol,{children:[`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Use a fast drive: a `,_jsx(_components.strong,{children:`Thunderbolt or USB4 NVMe SSD`}),`. Every job reads its VM image and writes its scratch disk there, and a macOS image is 45 GB, so a spinning disk, a USB-A flash drive or a network share makes every job slow (network shares are refused). Use a drive the Mac keeps powered and connected. A job running on a drive that goes away is stopped and run elsewhere, unpaid.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Format it as `,_jsx(_components.strong,{children:`APFS`}),` in Disk Utility. ExFAT, FAT and Mac OS Extended (HFS+) drives are refused, and so is a disk image: its space is the disk that holds its file.`]}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsx(_components.p,{children:`Turn on ownership, which macOS leaves off for external drives:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`sudo`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` diskutil`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` enableOwnership`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /Volumes/FastSSD`})]}),`\n`]})})}),`\n`]}),`\n`,_jsxs(_components.li,{children:[`\n`,_jsxs(_components.p,{children:[`Give the drive to the installer. Repeat `,_jsx(_components.code,{children:`--disk`}),` for more drives, and add `,_jsx(_components.code,{children:`--disk ~`}),` to keep using the internal disk too:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`darkbloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` setup`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --disk`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` /Volumes/FastSSD`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Setup checks each drive before it installs anything. When ownership is off, it prints the command and offers to run it. Add `,_jsx(_components.code,{children:`--plan`}),` first to see what each disk would get.`]}),`\n`]}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`Each disk keeps its own floor of free space (a tenth of the disk, 50 to 100 GiB) and holds the images of the jobs it runs: Darkbloom downloads an image once and copies it to the other disks that need it. The add-on uses a folder named `,_jsx(_components.code,{children:`DarkbloomSandbox`}),` at the top of each drive and nothing else on it.`]}),`\n`,_jsxs(_components.p,{children:[`If you unplug a drive, its slots stop taking jobs and nothing is written in its place. Plug it back in and they take jobs again once the add-on has checked the images on it. A drive that mounts after you log in is used as soon as it appears. `,_jsx(_components.code,{children:`status`}),` shows each disk, its free space and its slots.`]}),`\n`,_jsx(Heading,{level:`3`,id:`an-exfat-drive`,children:`An ExFAT drive`}),`\n`,_jsx(_components.p,{children:`To keep an ExFAT drive’s files, let the add-on make one encrypted disk image on it (a single file at its top; nothing is erased), and give that disk to the installer:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`~`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/DarkbloomSandbox/darkbloom-sandbox managed-disk create --on /Volumes/MyExFAT --size 1000`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`It prints the `,_jsx(_components.code,{children:`--disk`}),` to give. Its key stays on this Mac, and `,_jsx(_components.code,{children:`uninstall`}),` needs `,_jsx(_components.code,{children:`--delete-managed-disks`}),` to delete it with the install.`]}),`\n`,_jsx(Heading,{level:`2`,id:`build-cache`,children:`Build cache`}),`\n`,_jsx(_components.p,{children:`From add-on 1.2.1 your Mac keeps a build cache for the jobs it runs, on by default. A job restores its dependencies and build outputs from your disk instead of downloading them over your connection, and saves them there for the next job.`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`It takes up to 32 GiB on a 1 TB disk (16 GiB on 512 GB, 8 GiB on smaller ones), and only what the slots leave: never the floor, never a slot’s room.`}),`\n`,_jsxs(_components.li,{children:[`With less than 8 GiB left, it stays off, and `,_jsx(_components.code,{children:`status`}),` says how much to free.`]}),`\n`,_jsx(_components.li,{children:`It gives way to jobs and images at once, deleting its oldest entries.`}),`\n`,_jsx(_components.li,{children:`What it holds is encrypted inside the VM before it reaches your disk.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`To size it or turn it off, run the installer with `,_jsx(_components.code,{children:`--cache-size 16`}),` (GiB) or `,_jsx(_components.code,{children:`--no-cache`}),`. Without either, an earlier install’s size stays; a new install uses the default for its disk.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api-sandbox.darkbloom.dev/install.sh`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` sh`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --cache-size`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#B5CEA8`},children:` 16`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api-sandbox.darkbloom.dev/install.sh`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` sh`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --no-cache`})]}),`\n`]})})}),`\n`,_jsx(Heading,{level:`2`,id:`scheduling-and-pause`,children:`Scheduling and pause`}),`\n`,_jsx(_components.p,{children:`To stop taking new work for a while:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`2`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`darkbloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` pause`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`darkbloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` resume`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`No new job starts, and no agent sandbox starts or resumes on the Mac; jobs already running finish and are paid. The Mac stays paused after restarts and updates, and the console shows it as `,_jsx(_components.strong,{children:`Paused by owner`}),`. You do not need to sign in. Without the CLI, use `,_jsx(_components.code,{children:`~/DarkbloomSandbox/darkbloom-sandbox pause`}),` and `,_jsx(_components.code,{children:`resume`}),`.`]}),`\n`,_jsx(_components.p,{children:`To take jobs only in the hours you choose, set a weekly schedule in the Mac’s local time:`}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`3`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`3`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`~`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/DarkbloomSandbox/darkbloom-sandbox schedule set `}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:`'mon-fri 22:00-07:00'`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` 'weekends 00:00-24:00'`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`~`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/DarkbloomSandbox/darkbloom-sandbox schedule`})]}),`\n`,_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`~`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/DarkbloomSandbox/darkbloom-sandbox schedule off`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`Days are `,_jsx(_components.code,{children:`mon`}),` … `,_jsx(_components.code,{children:`sun`}),`, ranges such as `,_jsx(_components.code,{children:`mon-fri`}),`, or `,_jsx(_components.code,{children:`daily`}),`, `,_jsx(_components.code,{children:`weekdays`}),`, `,_jsx(_components.code,{children:`weekends`}),`; an end before the start runs past midnight. Outside every window no new job starts; a job still running when a window ends finishes. `,_jsx(_components.code,{children:`status`}),` and the console show `,_jsx(_components.strong,{children:`Paused by schedule`}),` until the next window.`]}),`\n`,_jsx(Heading,{level:`2`,id:`agent-sandboxes`,children:`Agent sandboxes`}),`\n`,_jsxs(_components.p,{children:[`Agent sandboxes are on by default from add-on 1.3.0. Their workspaces live in the same store as the build cache, with their own allowance: 96 GiB by default, set with the installer’s `,_jsx(_components.code,{children:`--workspace-size`}),`. Each workspace takes its disk’s room when it is created, and the room it may still grow into is kept beside CI jobs.`]}),`\n`,_jsxs(_components.p,{children:[`To turn agent sandboxes off, run the installer again with `,_jsx(_components.code,{children:`--no-agent-sessions`}),`. Later installs and updates keep them off, and CI jobs do not change.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`curl`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -fsSL`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` https://api-sandbox.darkbloom.dev/install.sh`}),_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:` |`}),_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:` sh`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` -s`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --`}),_jsx(_components.span,{style:{color:`#0550AE`,\"--shiki-dark\":`#569CD6`},children:` --no-agent-sessions`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`To stop new work only for a while, use `,_jsx(_components.code,{children:`pause`}),` or a schedule. They stop new CI jobs and new sandboxes alike.`]}),`\n`,_jsx(Heading,{level:`2`,id:`updates`,children:`Updates`}),`\n`,_jsx(_components.p,{children:`Updates are automatic. When Darkbloom approves a new release, the agent hears about it over its connection and checks within about two minutes; otherwise it checks every five minutes. (Add-on 1.2.0 and earlier check every hour.) Darkbloom may approve a release for some Macs before others.`}),`\n`,_jsx(_components.p,{children:`The agent installs a release only if all of these hold:`}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The app is signed with Darkbloom’s Apple Developer ID, and the release is signed with Darkbloom’s release key, which the installed app pins.`}),`\n`,_jsx(_components.li,{children:`The release is newer than the running version and supports your macOS version.`}),`\n`,_jsx(_components.li,{children:`Darkbloom’s servers already accept that build for your Mac.`}),`\n`]}),`\n`,_jsxs(_components.p,{children:[`The agent then stops taking jobs and waits for the running ones to finish. After that it swaps the app and restarts. You do not need to enroll again. If the new version does not connect to Darkbloom within three starts, or Darkbloom refuses it, the agent goes back to the previous version and skips the new one from then on. `,_jsx(_components.code,{children:`status`}),` shows the last check.`]}),`\n`,_jsx(Heading,{level:`2`,id:`uninstall`,children:`Uninstall`}),`\n`,_jsxs(_components.p,{children:[`Pause first and wait until `,_jsx(_components.code,{children:`status`}),` shows no job running: uninstalling stops the agent and any running job, and a stopped job is not paid.`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#953800`,\"--shiki-dark\":`#DCDCAA`},children:`darkbloom`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` sandbox`}),_jsx(_components.span,{style:{color:`#0A3069`,\"--shiki-dark\":`#CE9178`},children:` uninstall`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`The add-on’s own command is `,_jsx(_components.code,{children:`~/DarkbloomSandbox/darkbloom-sandbox uninstall`}),`. It removes `,_jsx(_components.code,{children:`~/DarkbloomSandbox`}),` (the app, images and state, except the workspaces it keeps), each work disk’s `,_jsx(_components.code,{children:`DarkbloomSandbox`}),` folder (only while that disk is mounted; it says which stays), and the LaunchAgent.`]}),`\n`,_jsxs(_components.p,{children:[`Uninstalling keeps the agent sandbox workspaces the Mac stores (add-on releases after 1.3.8). A workspace holds the files of someone’s sandbox, stopped or running. It exists on your Mac alone, so deleting it cannot be undone. `,_jsx(_components.code,{children:`uninstall`}),` prints how many it kept, how much disk they use and where they are:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`2`,language:`text`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`text`,children:_jsxs(_components.code,{language:`text`,numberOfLines:`2`,children:[_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{children:`==> Kept 2 agent sandbox workspaces of 2 sandboxes (64 GiB reserved, 12.4 GiB used) in ~/DarkbloomSandbox/agent/state/storage; to delete them: rm -rf /Users/you/DarkbloomSandbox/agent/state/storage`})}),`\n`,_jsx(_components.span,{className:`line`,children:_jsx(_components.span,{})})]})})}),`\n`,_jsxs(_components.ul,{children:[`\n`,_jsx(_components.li,{children:`The disk space printed as used is what they cost you. If you set the Mac up again the same way (the same disks), it finds them, and until you delete them they count against its workspace allowance, so it takes fewer new sandboxes. The room they may still grow into is also kept from its CI jobs, so it may take fewer CI jobs too.`}),`\n`,_jsx(_components.li,{children:`Today no sandbox can resume from a kept workspace, not even on this Mac set up again: Darkbloom sees that Mac as a new one. Keeping the workspace is what will let it resume once Darkbloom supports that. Darkbloom ends a sandbox that stays stopped for 30 days; after that its workspace is of no use to anyone, and nothing deletes it for you yet.`}),`\n`,_jsxs(_components.li,{children:[`To delete them as you uninstall, add `,_jsx(_components.code,{children:`--delete-workspaces`}),`. `,_jsx(_components.code,{children:`--yes`}),` alone never deletes them.`]}),`\n`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`~`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/DarkbloomSandbox/darkbloom-sandbox uninstall --delete-workspaces`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`After an uninstall, the Mac stays registered to your account but gets no work. To revoke it, remove it in the console: `,_jsx(_components.strong,{children:`Macs`}),`, then the Mac, then `,_jsx(_components.strong,{children:`Remove Mac`}),`. A removed Mac’s sandboxes can never resume. The Mac’s keychain keeps which host it was, so setting it up again replaces that host instead of adding a second one; you confirm the replacement when you approve the code. To make the Mac forget it, add `,_jsx(_components.code,{children:`--forget`}),`:`]}),`\n`,_jsx(CodeBlock,{filename:``,numberOfLines:`1`,language:`shellscript`,children:_jsx(_components.pre,{className:`shiki shiki-themes github-light-default dark-plus`,style:{backgroundColor:`#ffffff`,\"--shiki-dark-bg\":`#0B0C0E`,color:`#1f2328`,\"--shiki-dark\":`#D4D4D4`},language:`shellscript`,children:_jsxs(_components.code,{language:`shellscript`,numberOfLines:`1`,children:[_jsxs(_components.span,{className:`line`,children:[_jsx(_components.span,{style:{color:`#CF222E`,\"--shiki-dark\":`#D4D4D4`},children:`~`}),_jsx(_components.span,{style:{color:`#1F2328`,\"--shiki-dark\":`#D4D4D4`},children:`/DarkbloomSandbox/darkbloom-sandbox uninstall --forget`})]}),`\n`]})})}),`\n`,_jsxs(_components.p,{children:[`For a Mac that is no longer enrolled and fails to approve a replacement code, see `,_jsx(_components.a,{href:`/provider/sandbox-status#app-attest-key-stopped-working`,children:`check your Mac’s status`}),`.`]})]})}function MDXContent(props={}){const{wrapper:MDXLayout}={..._provideComponents(),...props.components};return MDXLayout?_jsx(MDXLayout,{...props,children:_jsx(_createMdxContent,{...props})}):_createMdxContent(props)}return{default:MDXContent};function _missingMdxReference(id,component){throw new Error(`Expected `+(component?`component`:`object`)+\" `\"+id+\"` to be defined: you likely forgot to import, pass, or provide it.\")}","frontmatter":{},"scope":{"config":{},"pageMetadata":{"title":"Set up your Mac to host sandboxes","description":"Install the Darkbloom Sandbox add-on, approve the Mac, choose work disks, size the build cache, and schedule, update or remove the add-on.","href":"/provider/sandbox-setup"}}},"mdxSourceWithNoJs":null},"mdxExtracts":{"tableOfContents":[{"title":"What the plan counts","slug":"what-the-plan-counts","depth":2,"children":[{"title":"Choose the number of slots","slug":"choose-the-number-of-slots","depth":3,"children":[]}]},{"title":"Disk budget","slug":"disk-budget","depth":2,"children":[]},{"title":"Work disks","slug":"work-disks","depth":2,"children":[{"title":"An ExFAT drive","slug":"an-exfat-drive","depth":3,"children":[]}]},{"title":"Build cache","slug":"build-cache","depth":2,"children":[]},{"title":"Scheduling and pause","slug":"scheduling-and-pause","depth":2,"children":[]},{"title":"Agent sandboxes","slug":"agent-sandboxes","depth":2,"children":[]},{"title":"Updates","slug":"updates","depth":2,"children":[]},{"title":"Uninstall","slug":"uninstall","depth":2,"children":[]}],"codeExamples":{}},"jsLinks":[],"subdomain":"eigenlabs-f49d2e97","siteName":"Darkbloom","title":"Set up your Mac to host sandboxes - Darkbloom","navMaps":{"firstHrefInVersion":{},"firstHrefInLanguage":{}},"lastModified":"2026-11-16T20:20:57.525Z","originalFileLocation":"provider/sandbox-setup.mdx"},"headHtml":"\u003cscript data-mint-head>(function(){var d=document.documentElement,p=null;if(!p){try{p=localStorage.getItem(\"isDarkMode\")}catch(e){}if(p==='true')p='dark';else if(p==='false')p='light';if(p!=='light'\u0026\u0026p!=='dark'\u0026\u0026p!=='system')p=\"system\"}var r=p==='system'?(matchMedia(\"(prefers-color-scheme: dark)\").matches?'dark':'light'):p;d.classList.remove(r==='dark'?'light':'dark');d.classList.add(r);d.setAttribute(\"data-theme-preference\",p)})();\u003c/script>\u003cmeta data-mint-head name=\"description\" content=\"Install the Darkbloom Sandbox add-on, approve the Mac, choose work disks, size the build cache, and schedule, update or remove the add-on.\">\u003cmeta data-mint-head name=\"application-name\" content=\"Darkbloom\">\u003cmeta data-mint-head name=\"generator\" content=\"Mintlify\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/eigenlabs-f49d2e97/zX4NJLyHK_yR9YZe/_generated/favicon/android-chrome-192x192.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"apple-touch-icon\" type=\"image/png\" sizes=\"180x180\" href=\"/mintlify-assets/_mintlify/favicons/eigenlabs-f49d2e97/zX4NJLyHK_yR9YZe/_generated/favicon/apple-touch-icon.png\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/eigenlabs-f49d2e97/zX4NJLyHK_yR9YZe/_generated/favicon/favicon-16x16.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/eigenlabs-f49d2e97/zX4NJLyHK_yR9YZe/_generated/favicon/favicon-32x32.png\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/eigenlabs-f49d2e97/zX4NJLyHK_yR9YZe/_generated/favicon/favicon.ico\" media=\"(prefers-color-scheme: light)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"192x192\" href=\"/mintlify-assets/_mintlify/favicons/eigenlabs-f49d2e97/zX4NJLyHK_yR9YZe/_generated/favicon-dark/android-chrome-192x192.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"16x16\" href=\"/mintlify-assets/_mintlify/favicons/eigenlabs-f49d2e97/zX4NJLyHK_yR9YZe/_generated/favicon-dark/favicon-16x16.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"icon\" type=\"image/png\" sizes=\"32x32\" href=\"/mintlify-assets/_mintlify/favicons/eigenlabs-f49d2e97/zX4NJLyHK_yR9YZe/_generated/favicon-dark/favicon-32x32.png\" media=\"(prefers-color-scheme: dark)\">\u003clink data-mint-head rel=\"shortcut icon\" type=\"image/x-icon\" href=\"/mintlify-assets/_mintlify/favicons/eigenlabs-f49d2e97/zX4NJLyHK_yR9YZe/_generated/favicon-dark/favicon.ico\" media=\"(prefers-color-scheme: dark)\">\u003cmeta data-mint-head property=\"og:title\" content=\"Set up your Mac to host sandboxes - Darkbloom\">\u003cmeta data-mint-head property=\"og:description\" content=\"Install the Darkbloom Sandbox add-on, approve the Mac, choose work disks, size the build cache, and schedule, update or remove the add-on.\">\u003cmeta data-mint-head property=\"og:site_name\" content=\"Darkbloom\">\u003cmeta data-mint-head property=\"og:url\" content=\"https://docs.darkbloom.dev/provider/sandbox-setup\">\u003cmeta data-mint-head property=\"og:type\" content=\"website\">\u003cmeta data-mint-head property=\"og:image\" content=\"https://eigenlabs-f49d2e97.mintlify.site/_mintlify/api/og/v2?division=Host+CI+and+sandboxes\u0026amp;title=Set+up+your+Mac+to+host+sandboxes\u0026amp;description=Install+the+Darkbloom+Sandbox+add-on%2C+approve+the+Mac%2C+choose+work+disks%2C+size+the+build+cache%2C+and+schedule%2C+update+or+remove+the+add-on.\u0026amp;theme=33807c18711f3ad0adc203ac\u0026amp;signature=91eeec2002b29f8753cc34811dd419b677682abb2a98b798e7387e28fa6430b1\">\u003cmeta data-mint-head property=\"og:image:width\" content=\"1200\">\u003cmeta data-mint-head property=\"og:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"twitter:card\" content=\"summary_large_image\">\u003cmeta data-mint-head name=\"twitter:title\" content=\"Set up your Mac to host sandboxes - Darkbloom\">\u003cmeta data-mint-head name=\"twitter:description\" content=\"Install the Darkbloom Sandbox add-on, approve the Mac, choose work disks, size the build cache, and schedule, update or remove the add-on.\">\u003cmeta data-mint-head name=\"twitter:image\" content=\"https://eigenlabs-f49d2e97.mintlify.site/_mintlify/api/og/v2?division=Host+CI+and+sandboxes\u0026amp;title=Set+up+your+Mac+to+host+sandboxes\u0026amp;description=Install+the+Darkbloom+Sandbox+add-on%2C+approve+the+Mac%2C+choose+work+disks%2C+size+the+build+cache%2C+and+schedule%2C+update+or+remove+the+add-on.\u0026amp;theme=33807c18711f3ad0adc203ac\u0026amp;signature=91eeec2002b29f8753cc34811dd419b677682abb2a98b798e7387e28fa6430b1\">\u003cmeta data-mint-head name=\"twitter:image:width\" content=\"1200\">\u003cmeta data-mint-head name=\"twitter:image:height\" content=\"630\">\u003cmeta data-mint-head name=\"msapplication-config\" content=\"/mintlify-assets/_mintlify/favicons/eigenlabs-f49d2e97/zX4NJLyHK_yR9YZe/_generated/favicon/browserconfig.xml\">\u003cmeta data-mint-head name=\"apple-mobile-web-app-title\" content=\"Darkbloom\">\u003cmeta data-mint-head name=\"msapplication-TileColor\" content=\"#0B44FF\">\u003clink data-mint-head rel=\"canonical\" href=\"https://docs.darkbloom.dev/provider/sandbox-setup\">\u003clink data-mint-head rel=\"alternate\" type=\"application/xml\" href=\"/sitemap.xml\">\u003clink data-mint-head rel=\"alternate\" type=\"text/markdown\" href=\"/provider/sandbox-setup.md\">\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@graph\":[{\"@type\":\"Organization\",\"@id\":\"https://docs.darkbloom.dev/#organization\",\"name\":\"Darkbloom\",\"url\":\"https://docs.darkbloom.dev\",\"logo\":{\"@type\":\"ImageObject\",\"url\":\"https://mintcdn.com/eigenlabs-f49d2e97/IspAEDzrILVDDfNo/images/Blacklogo.png?fit=max\u0026auto=format\u0026n=IspAEDzrILVDDfNo\u0026q=85\u0026s=0b259f057d233a45818dfca27115accb\"}},{\"@type\":\"WebSite\",\"@id\":\"https://docs.darkbloom.dev#website\",\"name\":\"Darkbloom\",\"url\":\"https://docs.darkbloom.dev\",\"publisher\":{\"@id\":\"https://docs.darkbloom.dev/#organization\"}},{\"@type\":\"WebPage\",\"@id\":\"https://docs.darkbloom.dev/provider/sandbox-setup#webpage\",\"url\":\"https://docs.darkbloom.dev/provider/sandbox-setup\",\"name\":\"Set up your Mac to host sandboxes\",\"description\":\"Install the Darkbloom Sandbox add-on, approve the Mac, choose work disks, size the build cache, and schedule, update or remove the add-on.\",\"dateModified\":\"2026-11-16T20:20:57.525Z\",\"isPartOf\":{\"@id\":\"https://docs.darkbloom.dev#website\"},\"breadcrumb\":{\"@id\":\"https://docs.darkbloom.dev/provider/sandbox-setup#breadcrumb\"}},{\"@type\":\"BreadcrumbList\",\"@id\":\"https://docs.darkbloom.dev/provider/sandbox-setup#breadcrumb\",\"itemListElement\":[{\"@type\":\"ListItem\",\"position\":1,\"name\":\"Host CI and sandboxes\",\"item\":\"https://docs.darkbloom.dev/provider/sandbox-hosting\"},{\"@type\":\"ListItem\",\"position\":2,\"name\":\"Set up your Mac to host sandboxes\",\"item\":\"https://docs.darkbloom.dev/provider/sandbox-setup\"}]},{\"@type\":[\"Article\",\"TechArticle\"],\"@id\":\"https://docs.darkbloom.dev/provider/sandbox-setup#article\",\"headline\":\"Set up your Mac to host sandboxes\",\"name\":\"Set up your Mac to host sandboxes\",\"description\":\"Install the Darkbloom Sandbox add-on, approve the Mac, choose work disks, size the build cache, and schedule, update or remove the add-on.\",\"url\":\"https://docs.darkbloom.dev/provider/sandbox-setup\",\"mainEntityOfPage\":{\"@id\":\"https://docs.darkbloom.dev/provider/sandbox-setup#webpage\"},\"dateModified\":\"2026-11-16T20:20:57.525Z\",\"publisher\":{\"@id\":\"https://docs.darkbloom.dev/#organization\"},\"isPartOf\":{\"@id\":\"https://docs.darkbloom.dev#website\"}}]}\u003c/script>\u003cscript data-mint-head type=\"application/ld+json\">{\"@context\":\"https://schema.org\",\"@type\":\"WebSite\",\"name\":\"Darkbloom\",\"publisher\":{\"@type\":\"Organization\",\"name\":\"Darkbloom\"},\"provider\":{\"@type\":\"Organization\",\"name\":\"Mintlify\",\"url\":\"https://mintlify.com\"}}\u003c/script>","agentPointerHref":"/provider/sandbox-setup.md","siteName":"Darkbloom","nav":{"global":null,"tabs":[{"tab":"Get started","pages":[{"title":"Get started","href":"/introduction"}]},{"tab":"Inference","pages":[{"title":"Inference","href":"/quickstart-consumer"}]},{"tab":"CI","pages":[{"title":"CI","href":"/ci/overview"}]},{"tab":"Sandboxes","pages":[{"title":"Sandboxes","href":"/sandboxes/overview"}]},{"tab":"Providers","groups":[{"group":"Get started","pages":[{"title":"Quickstart: become a Darkbloom provider","href":"/quickstart-provider"},{"title":"Earn by sharing your Mac's compute on Darkbloom","href":"/provider/overview"}]},{"group":"Serve inference","pages":[{"title":"Installing and setting up the provider agent","href":"/provider/install"},{"title":"darkbloom CLI: complete command reference","href":"/provider/cli-reference"},{"title":"Manage your provider with the Darkbloom desktop app","href":"/provider/macos-app"},{"title":"Schedule when your Mac serves inference and sandbox jobs","href":"/provider/scheduling"}]},{"group":"Host CI and sandboxes","pages":[{"title":"Host CI jobs and sandboxes on your Mac","description":"Run other people's GitHub Actions jobs and agent sandboxes in virtual machines on your Apple silicon Mac, beside the Darkbloom inference provider, and earn for the time they run.","href":"/provider/sandbox-hosting"},{"title":"Set up your Mac to host sandboxes","href":"/provider/sandbox-setup"},{"title":"Check your Mac's sandbox status","description":"Read every Darkbloom Sandbox status state, understand the free-disk floor and waiting images, and fix the common problems that stop a Mac from taking work.","href":"/provider/sandbox-status"}]},{"group":"Earnings","pages":[{"title":"Understanding and withdrawing your earnings","href":"/provider/earnings"}]}]},{"tab":"API Reference","pages":[{"title":"API Reference","href":"/reference/chat-completions"}]}]},"basePath":"","title":"Set up your Mac to host sandboxes - Darkbloom","deploymentId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","buildId":"dpl_Em2U4NQQ2N2DE3HPbPUJVZLnAtvc","dynamics":["07c022d89b","a74be98ba7"],"chunks":["Frame-DMn5ZJp6.js","DynamicMarkdown-5yMTCLas.js","zoom-image-lightbox-BUkqX3JF.js","lightbox-handle-r17bVUz3.js"]}