Devbox pairs local workspaces with remote SSH hosts for safe on-demand Mutagen sync, persistent tmux shells, detached jobs on Linux, and port forwarding.
Created at Exowatt.
Maintained. Releases target macOS arm64/x64 and Linux arm64/x64.
Public GitHub release assets require no credentials. Download and inspect the installer, then run:
sh ./devbox-install.shThe installer verifies the archive using the release's SHA256SUMS and installs to ~/.local/bin by default. Set DEVBOX_INSTALL_DIR for another destination, DEVBOX_VERSION=vX.Y.Z for a tagged release, or DEVBOX_RELEASE_REPO=owner/repo for a fork. See installation and source build.
Prepare an SSH-accessible host with a known host key and an empty remote workspace. For persistent shells, install tmux there; for detached jobs use a Linux host with systemd user services. Run db or devbox (both names refer to the same CLI):
# Start from the machine with the existing files:
db init --host devbox.example.com --user alice --local-root ~/work --remote-root /home/alice/work --fingerprint SHA256:<reviewed-host-key>
# On another machine, join that same hub:
db connect --host devbox.example.com --user alice --remote-root /home/alice/work --fingerprint SHA256:<reviewed-host-key>
db sync
db status
db shellVerify the host-key fingerprint out of band. Do not pair nonempty roots without reading the conflict and adoption guidance in agent setup. See operator quickstart for profiles, recovery and teardown.
No hosted service, private GitHub release, account token or organization configuration is needed. Profiles store SSH endpoint, pinned host key, local and remote roots, sync exclusions and optional proxy command under ${DEVBOX_STATE_ROOT:-$HOME/.local/state/devbox}. Mutagen v0.18.1 is fetched from its public release and checksum-verified on first sync; use DEVBOX_MUTAGEN_BINARY to select a separately installed binary. Devbox downloads Mutagen at runtime; Mutagen is a separately licensed third-party tool (see its licence; some official release builds include SSPL-licensed components) and is not redistributed by this project. DEVBOX_POWER_CLI optionally names a power-provider executable for checking a proxy-powered host's status before syncing; without it no provider is called. DEVBOX_RELEASE_REPO selects an alternate public GitHub owner/repo for the installer (default exowatt-oss/devbox). Use db profile --help, db device --help, db mutagen status and the reference.
Node.js 24 and pnpm 10.24.0:
pnpm install --frozen-lockfile
pnpm run ci
pnpm bundleOriginal code is licensed under Apache-2.0. See NOTICE.
See CONTRIBUTING. Sign off commits with git commit -s (DCO).
Report vulnerabilities through private vulnerability reporting, or email software@exowatt.com. See the security policy; do not open a public issue.