Install the CLI

Install one devboxes command for terminal sign-in, dispatch, and running tasks on your machine. Every installation runs the same self-contained executable.

Install from npm

Node and npm are used only during installation. Running devboxes needs neither Node nor Bun.

npm install --global devboxes
devboxes --version

Do not disable npm lifecycle scripts or optional dependencies. They select and install the native package for your operating system.

Install without npm

On macOS or glibc Linux:

curl --proto '=https' --tlsv1.2 -fsSL \
  https://raw.githubusercontent.com/firatoezcan/devboxes-cli/main/install | sh

On Windows PowerShell:

irm https://raw.githubusercontent.com/firatoezcan/devboxes-cli/main/install.ps1 | iex

The installer selects a versioned release for your system, verifies its SHA-256 checksum, checks its reported version, then replaces the current user-local command. It does not edit your shell profile, write configuration, or sign you in.

Native binaries are not yet publisher-signed. A managed device that requires Developer ID/notarization or Authenticode may block them; do not weaken your organization's security policy to install Devboxes.

Continue setup

Add the printed install directory to PATH when the installer asks. Then follow the Quickstart to sign in, register the runner, and dispatch your first run. Configuration covers unattended and self-hosted setups.

Next: Quickstart — registering a runner and dispatching your first run.