How to set up Darkbloom on a Mac, step by step
Updated
Short answer: let BloomGauge set it up. BloomGauge downloads and sets up Darkbloom for you. All you do is create a Darkbloom account (or sign in to yours). About 5 minutes of your time, no Terminal; the model finishes downloading in the background. BloomGauge checks your Mac, you agree once, it downloads Darkbloom and checks its Apple signature, you sign in to Darkbloom in your browser while the model downloads, and it starts serving. We make BloomGauge, so weigh this accordingly. Prefer to do it yourself? Update to macOS 27, run Darkbloom’s installer in Terminal (curl -fsSL https://api.darkbloom.dev/install.sh | bash), link your account with darkbloom login, then run darkbloom start. The Terminal steps below come from Darkbloom’s provider docs and its setup page in the console (links at the end).
What you need
- BloomGauge runs on macOS 14+. To earn with Darkbloom you need an Apple Silicon Mac with 48 GB+ memory and macOS 27 or later: from Darkbloom 0.9.18, new providers are only sent work on macOS 27+, and Darkbloom pays base rewards only to Macs on macOS 27 or later that Apple’s app check has approved.
- BloomGauge checks your chip, memory, macOS version and free disk space for you before it installs anything. To check yourself: Apple menu → About This Mac. Darkbloom’s installer refuses Intel Macs.
- A Darkbloom account, to link the Mac to. Its earnings go to that account.
- Power and a steady internet connection. The provider only connects out (HTTPS to api.darkbloom.dev), so no router ports need opening.
- Free disk space for models. The model picker shows download sizes before you choose.
Set up Darkbloom with BloomGauge
- Download BloomGauge from bloomgauge.io, drag it into Applications and open it. macOS asks once whether to open an app downloaded from the internet; BloomGauge is signed and notarized by Apple.
- BloomGauge checks the Mac: Apple Silicon, 48 GB or more memory, macOS 27 and enough free disk space for the model. Below macOS 27 it offers Open Software Update first, then reopens after the restart and continues. Under 48 GB it says Darkbloom won’t accept the Mac, and BloomGauge works as a viewer only.
- One screen, Get this Mac earning, lists what BloomGauge will do and the model it picked for your Mac (Change is optional). Open at Login, Manager on, Keep my model loaded and notifications start ticked; untick any you don’t want. Press Agree and set up. Starting to serve means you accept Darkbloom’s Terms of Service, linked on that screen.
- BloomGauge downloads Darkbloom from Darkbloom’s own server (api.darkbloom.dev) and installs it only after the checksums match, the app is signed by Eigen Labs (Apple developer team SLDQ2GJ6TL) and Apple’s notarization check accepts it. It goes in your home folder (~/.darkbloom). No administrator password is needed.
- Your browser opens on Darkbloom’s sign-in page, and BloomGauge shows the one-time code. Sign in to Darkbloom and approve this Mac. BloomGauge never sees your password. The model downloads at the same time.
- When both are done, BloomGauge starts Darkbloom. A Getting ready card ticks off each step and then waits for Darkbloom to approve the Mac, usually within minutes, sometimes a few hours. You can close the window; setup carries on and picks up where it left off after a quit or restart.
What you still do yourself
- Sign in to Darkbloom in your browser and approve the Mac. If you don’t have a Darkbloom account yet, you create it there.
- Update to macOS 27 first if the Mac runs an older version: Software Update and a restart.
- Allow BloomGauge’s notifications when macOS asks, if you want them.
- Wait for the model download (Gemma 4 26B, for example, is 15.6 GB) and for Darkbloom’s approval. Neither needs you at the Mac.
- Set up payouts on Darkbloom’s console later. BloomGauge doesn’t handle payouts.
- If any check on Darkbloom’s download fails, BloomGauge doesn’t install it. It says setup couldn’t finish and shows Try again and Send report buttons. If it keeps failing, install Darkbloom from darkbloom.dev yourself and reopen BloomGauge.
- Already running Darkbloom? BloomGauge skips the steps that are done and never reinstalls, signs out or restarts a running provider during setup. To undo, More → This Mac → Remove Darkbloom from this Mac… moves it to the Trash.
Set up Darkbloom yourself (Terminal)
The same setup by hand, in four parts: update macOS, install, link your account, then pick a model and start. It follows Darkbloom’s provider docs.
1. Update to macOS 27 first
On macOS 27 or later, Darkbloom verifies the Mac with Apple’s App Attest, and the installer skips the MDM profile download and System Settings approval. On older macOS the installer opens System Settings to enroll the Mac in Darkbloom’s MDM, which Darkbloom says will be switched off soon. So update first in System Settings → General → Software Update, then install. Already have Darkbloom’s profile from an earlier setup? Keep it until darkbloom unenroll confirms App Attest migration is ready, and keep any employer management profile.
2. Install the provider
- Open Terminal on the Mac you want to connect.
- Run Darkbloom’s install command: curl -fsSL https://api.darkbloom.dev/install.sh | bash
- Then run source ~/.zshrc so Terminal finds the darkbloom command.
- The installer needs no sudo. It checks the Mac is Apple Silicon, downloads the provider and verifies its checksums, installs it under ~/.darkbloom, adds it to your PATH, and runs darkbloom doctor at the end. It doesn’t download a model yet.
3. Link your account
- Run darkbloom login.
- It opens your browser and shows a one-time code. Approve it with the Darkbloom account where you want this Mac’s earnings to go.
- Wait for “Account linked successfully!” in Terminal before you continue. If you skip this step, darkbloom start offers to link the account for you.
4. Pick a model and start
- Run darkbloom start. Starting the provider means you accept Darkbloom’s Terms of Service, which it shows first.
- It checks the Mac (System Integrity Protection, GPU and memory), then shows a model picker. Choose what to serve; the article on which Darkbloom model to run helps you choose.
- It asks what to do with memory when idle: Always ready keeps models loaded, Free when idle (the default) unloads them after 60 minutes without requests and reloads them on demand.
- It downloads the models and starts the provider in the background. The service starts again every time you log in. The first download can take a while, so keep the Mac on power and online.
5. Check it’s verified and online
- Run darkbloom status. It shows the configuration, hardware, the running provider and a Trust line. hardware / online means Darkbloom can send your Mac public paid work.
- Run darkbloom doctor. Lines marked ✗ are failures; it covers hardware, Metal, SIP, the account link, verification and whether it can reach Darkbloom.
- Open the Darkbloom console dashboard to see this Mac’s connection, verification and earnings. A linked Mac may still be downloading models or waiting for verification, and being connected alone doesn’t prove it is serving or earning.
- On older macOS, finish the legacy setup instead: run darkbloom enroll and approve the Darkbloom profile in System Settings.
6. Keep it earning
- Keep a model loaded: darkbloom idle keep-loaded, then darkbloom restart. With the default Free when idle setting, the model unloads after 60 minutes without requests, which pauses base rewards.
- Keep the Mac awake, on power and logged in. Verification needs a user logged in at the Mac’s screen, so turn on automatic login and turn off log out when idle.
- Running it without a monitor? Start it from the desktop session (Screen Sharing works), not over SSH. See the headless Mac article.
- The Darkbloom Mac setup checklist covers the rest: sleep, airflow, network, and what to check after updates.
Common setup errors
- Online but Trust shows self_signed or App Attest pending: see Darkbloom verification pending.
- darkbloom unenroll refuses or errors while you move from MDM to App Attest: see the darkbloom unenroll error article.
- launchctl bootstrap failed, or it won’t verify over SSH: see running Darkbloom on a headless Mac.
- A model won’t load, or says there isn’t enough memory: see Darkbloom model won’t load.
Sources
- Darkbloom provider setup page: console.darkbloom.dev/providers/setup
- Provider quickstart (install, login, start, verify): github.com/Layr-Labs/d-inference/blob/master/docs/provider/quickstart.md
- Installation (what the installer checks and writes): github.com/Layr-Labs/d-inference/blob/master/docs/provider/installation.md
- Hardware requirements: github.com/Layr-Labs/d-inference/blob/master/docs/provider/hardware-requirements.md
- Attestation and trust levels: github.com/Layr-Labs/d-inference/blob/master/docs/provider/attestation.md
- CLI reference (darkbloom start, status, doctor, idle): github.com/Layr-Labs/d-inference/blob/master/docs/provider/cli-reference.md
How BloomGauge helps
BloomGauge sets up Darkbloom for you, no Terminal needed: it checks the Mac, downloads and verifies Darkbloom, opens Darkbloom’s sign-in in your browser and starts serving. After that it runs Darkbloom day to day: it shows live and confirmed earnings per model and hour, runs the model expected to pay most on your Mac (you can turn the Manager off any time), recovers when the provider stalls or a load fails, and you can check and control it from your phone over your own Tailscale connection.
Questions
How do I set up Darkbloom on a Mac?
With BloomGauge: install it, press Agree and set up, and sign in to Darkbloom in your browser. It checks the Mac, installs and verifies Darkbloom, downloads a model and starts serving. Or do it yourself: update to macOS 27, then in Terminal run curl -fsSL https://api.darkbloom.dev/install.sh | bash, link your account with darkbloom login, and run darkbloom start to pick a model and start serving. Check it with darkbloom status and darkbloom doctor.
Do I need the Terminal to set up Darkbloom?
Not with BloomGauge. It installs Darkbloom, links your account through Darkbloom’s own browser sign-in and starts serving, with no administrator password; in the rare case it can’t complete the install itself, it says so and offers Try again and Send report; you can also install Darkbloom from darkbloom.dev and reopen BloomGauge. You still sign in to Darkbloom in your browser, and a Mac below macOS 27 updates macOS first. If BloomGauge can’t verify Darkbloom’s download, it doesn’t install it and tells you so. Without BloomGauge, Darkbloom’s setup is three Terminal commands: the installer, darkbloom login and darkbloom start.
How long does Darkbloom setup take?
About 5 minutes of your time with BloomGauge: install it, press Agree and set up, and create a Darkbloom account (or sign in) in your browser. BloomGauge downloads and sets up Darkbloom, no Terminal. The model is a large download (about 16 GB for the default), so it keeps downloading in the background; how long depends on your connection, and the Mac starts earning once it has loaded and Darkbloom has approved it.
What Mac do I need for Darkbloom?
BloomGauge runs on macOS 14+. To earn with Darkbloom you need an Apple Silicon Mac with 48 GB+ memory and macOS 27 or later: from Darkbloom 0.9.18, new providers are only sent work on macOS 27+, and Darkbloom pays base rewards only to Macs on macOS 27 or later that Apple’s app check has approved.
Related
- Darkbloom provider on a Mac: setup checklist
- Which Darkbloom model should I run on my Mac?
- Darkbloom verification pending: MDM, App Attest and trust on macOS 27
- Running Darkbloom on a headless Mac: no monitor, SSH and automatic login
- darkbloom unenroll errors: moving from MDM to App Attest, step by step
- Darkbloom model won’t load: not enough memory
Updated 2026-10-01. Still stuck? Ask in #bloomgauge on the Darkbloom Slack (join it here, free) or contact us. BloomGauge is independent and not affiliated with Darkbloom.