Sign in Subscribe
docker

Docker SBX v0.31.0-rc1: Settings Store, Registry Auth & Branch Rework

Docker SBX v0.31.0-rc1 adds a persistent settings store, registry credentials support, and reworks the --branch workflow to use in-container git-daemon clones. Kits are now experimental with a new spec shape.

Docker SBX v0.31.0-rc1: Settings Store, Registry Auth & Branch Rework

TL;DR

  • Persistent settings store with new sbx settings commands
  • Registry credentials support via sbx secret set --registry
  • --branch workflow now uses in-container git-daemon clone instead of worktrees
  • Kits marked experimental with new spec shape (breaking change for kit authors)

New

  • Settings store — Persistent configuration with sbx settings list/get/set/unset commands for managing sandbox preferences
  • Registry credentials — Add Docker registry auth via sbx secret set --registry
  • OAuth improvements — Ignore OPENAI_API_KEY when OAuth is configured, support redirects in custom OAuth handlers
  • Unified terminal environment — Terminal variables now consistent across sbx run and sbx exec
  • Policy visibility — Show policy and rule names in CLI output with new filtering options
  • Daemon logout — sbx logout now stops the daemon and all running sandboxes

Changed

  • --branch workflow rework — Replaced worktrees with in-container clone served over git-daemon; host forge remotes now propagated into the clone
  • Kit spec shape — New kit specification format with collapsed engine duplication (breaking change for kit authors)
  • Kits marked experimental — Kits now flagged as experimental with verbose error reporting for apply failures

Fixed

  • Sort template ls output by repository then tag
  • Retry ExecResize to keep agent TUI in sync
  • Set TERM=xterm-256color when exec'ing with -t
  • Move state directory symlink from /tmp to ~/.sbx/run/
  • Add bracketed [::1] to NO_PROXY for IPv6 loopback
  • Accept PAT-issued Docker Hub tokens
  • Restore symmetric git remote lifecycle on --branch sandbox stop/restart
  • Build sailor's ffi crate (not ffi-krun) in packaging

Breaking Changes

  • Kit spec shape has changed — kit authors must update their kit specifications to match the new format with collapsed engine duplication

Update: Install the latest release candidate with docker pull docker/sbx:v0.31.0-rc1 or check the release page for installation instructions.

Source: Docker

Read next