Prerequisites

Before you begin, make sure you have the following:

Docker Desktop (macOS / Windows) or Docker Engine (Linux) — must be installed and running. d:spatch uses Docker to sandbox agent workspaces.
For development — Flutter 3.11+ if you plan to build from source.

Docker is required

Docker Desktop must be running before you launch d:spatch. Agent workspaces run inside Docker containers, and workspace creation will fail without a running Docker daemon.

Linux: Install Sysbox

On Linux, d:spatch requires Sysbox — an OCI runtime that enables Docker-in-Docker and enhanced isolation for agent containers.

Install the Sysbox package

Download the latest .deb or .rpm package from the Sysbox releases page and install it:

# Debian / Ubuntu
wget https://downloads.nestybox.com/sysbox/releases/v0.6.6/sysbox-ce_0.6.6-0.linux_amd64.deb
sudo apt install ./sysbox-ce_0.6.6-0.linux_amd64.deb

# Fedora / RHEL
wget https://downloads.nestybox.com/sysbox/releases/v0.6.6/sysbox-ce-0.6.6-0.linux.x86_64.rpm
sudo rpm -i sysbox-ce-0.6.6-0.linux.x86_64.rpm

Verify the installation

sudo systemctl status sysbox

You should see active (running) for both sysbox-mgr and sysbox-fs.

Sysbox on macOS / Windows

Sysbox is not required on macOS or Windows. Docker Desktop on those platforms already provides the necessary isolation.

Install d:spatch

Pre-built binaries are available for Windows and macOS on the GitHub Releases page.

Download the appropriate archive for your platform, extract it, and run the dspatch binary.

Clone the repository

git clone https://github.com/oakisnotree/dspatch.git

Install dependencies

cd dspatch/app && flutter pub get

Run code generation

dart run build_runner build --delete-conflicting-outputs

Launch the app

flutter run

What's next

Once d:spatch is running and Docker is active, you're ready to set up your first agent and workspace.

Next: Your first agent & workspace →

Installation