Install SpanDock in a few minutes
SpanDock is one app for macOS, Linux and Windows. On first launch it asks whether this computer is a server or a client, and remembers the answer. Installed apps update themselves. Check the requirements and size your server first.
SpanDock is free to use under the End User License Agreement, with paid plans for larger teams.
- SiteThe website and your account
- ServerYour server: the hub, or a satellite
- ClientA developer machine sending telemetry
| You have | Install with | Updates |
|---|---|---|
| A Mac | brew install --cask spandock/spandock/spandock | The app updates itself (or brew upgrade --greedy) |
| A Mac, without Homebrew | The DMG, plus one Terminal command | The app updates itself |
| A Linux machine or VM, or a Mac without a screen | brew install spandock/spandock/spandock, or the tarball | Homebrew: brew upgrade spandock. Tarball: the app updates itself |
| Windows | The zip | The app updates itself |
macOS
With Homebrew (recommended)
brew install --cask spandock/spandock/spandock
open -a SpanDockUse the full name as shown, so Homebrew trusts the cask and keeps it current. To remove it: brew uninstall --cask spandock (add --zap to delete settings and data too).
Without Homebrew
- Download
SpanDock-<version>-macos-arm64.dmg(Apple Silicon) from the latest release. Intel Macs have a-amd64.dmgin major releases only (1.0, 2.0, …). - Open it and drag SpanDock to Applications.
- Open SpanDock from Applications.
SpanDock is signed with SpanDock's Developer ID and notarized by Apple, so macOS opens it without asking.
Linux
With Homebrew
brew install spandock/spandock/spandock
spandock -role=server -accept-eula -open=false -menubar=false # first start: approve the code it prints, then Ctrl-C
brew services start spandock # run it in the backgroundEvery server needs a spandock.com account (a Personal license is free). On its first start a new server prints a link and a code and waits: open the link on any device, sign in and approve it, and it starts. A server upgraded from an older version that isn't activated yet: spandock license login. Air-gapped Enterprise: add -license-file FILE.
Update with brew upgrade spandock. A Homebrew install never replaces itself; the dashboard tells you when a new version is out.
From the tarball
curl -fLO https://github.com/SpanDock/spandock-releases/releases/latest/download/spandock-linux-amd64.tar.gz
tar -xzf spandock-linux-amd64.tar.gz
./spandock -role=server -accept-eula -open=false -menubar=false # approve the code it printsUse spandock-linux-arm64.tar.gz on ARM. Keep the binary in a folder its user can write to (for example ~/.local/bin) so it can update itself. Settings → General → Open at login installs a user service.
Windows
From the zip
Download spandock-windows-amd64.zip from the latest release, unzip it and run spandock.exe. The dashboard opens in your browser.
Expand-Archive spandock-windows-amd64.zip -DestinationPath $env:LOCALAPPDATA\SpanDock
& "$env:LOCALAPPDATA\SpanDock\spandock.exe"A server without a screen
spandock -role=server -accept-eula -open=false -menubar=false # first start: approve the code it prints
spandock admin pair my-laptop # a single-use pairing code for a client
spandock admin management-token my-laptop # lets that client manage this server
spandock admin clients # list clients; approve with: spandock admin approve CLIENT-IDOn the laptop
- Install SpanDock and choose client on the first launch.
- Paste the pairing code under Settings → Server connection.
- Paste the management token under Settings → Server management.
- Choose Open server dashboard: the server's dashboard opens through the encrypted tunnel.
The first launch
- The dashboard opens at
http://127.0.0.1:8787and asks whether this computer is a server or a client. To use SpanDock on your own, run a server on your computer. - Server: sign in to activate it. The dashboard shows a code; choose Sign in, or open spandock.com/activate on any device, and approve the server. Signing up is free and creates a Personal license. Clients need no account, only a pairing code.
- Server: add clients under Clients → Add client. Each gets a single-use pairing code. Add destinations under Destinations.
- Client: paste the pairing code under Settings → Server connection.
- Everywhere: Integrations configures Claude Code, Codex, Gemini CLI and other tools to report to SpanDock. Restart the tool afterwards.
Join a satellite
- On the hub: Settings → Scaling → Add server. Copy the join code; it works once, for 30 minutes.
- On the new server: install SpanDock, choose Join it as a satellite on the first launch, and paste the code.
- On the hub: Clients → Add client now asks which server each new client connects to. Clients fail over between servers by themselves.
Without a screen
Pass the code in the environment rather than on the command line, so it stays out of the process list:
SPANDOCK_JOIN_CODE='spandock-join:…' spandock -role=server -accept-eula -open=false -menubar=falseChecking a download
Every release lists the SHA-256 of each file in checksums.txt.
shasum -a 256 -c checksums.txt --ignore-missing # macOS
sha256sum -c checksums.txt --ignore-missing # LinuxNext: create your account
Your server asks you to sign in on its first start. Signing up is free and creates a Personal license.