Introduction to DbxSmith
DbxSmith is a professional-grade provisioning and management suite for Distrobox and Podman. It turns raw distrobox create commands into reproducible, strategy-driven environments with deterministic UI, stateful registries, and atomic teardowns.
Why DbxSmith?
Out of the box, Distrobox creates containers that share your host's home directory and network. That is convenient, but carries real risk. DbxSmith adds a strategy layer on top:
| Feature | Native Distrobox CLI | DbxSmith |
|---|---|---|
| Data Isolation | Shared Host Home — risky | Isolated home paths (~/boxes/<name>) |
| Network Security | Open host network | Strategy-based: airgapped or dedicated NAT bridge |
| Visual Safety | Default terminal theme | Image-hash derived background colors — always know where you are |
| State Persistence | Creation flags forgotten | Registry manifests (~/.config/dbx-smith/registry/) |
| Teardown | Container only — artifacts left behind | Atomic: removes container, home dir, network bridge, and alias fragments |
Quick Start
1. Install
curl -fsSL https://raw.githubusercontent.com/arijit1begins/dbx-smith/main/install.sh | bash
2. Provision a box
dbx-smith-spin standard devbox docker.io/library/ubuntu:latest dev
3. Enter it
dbx-smith devbox
4. Tear it down
dbx-smith-rm --purge devbox
Strategies at a glance
| Strategy | Isolation | Best for |
|---|---|---|
standard | None — shares host home + network | Daily driver, normal development |
airgapped | Full network + home isolation | Sensitive code, untrusted scripts, private keys |
ghost | Identity only — different user + hostname | Permission-sensitive testing, clean-slate identity |
isolated-net | Home isolation + dedicated NAT bridge | Microservices, port-clashing services |
See Strategies for full details, technical breakdowns, and example commands.
Supported Platforms
DbxSmith is built for the Linux ecosystem. It relies on low-level kernel features (namespaces, cgroups) exposed by Podman and Distrobox.
- ✅ Supported: All major Linux distributions (Fedora, Ubuntu, Debian, Arch, OpenSUSE, etc.)
- ❌ Unsupported: macOS and Windows.
- Note for Mac users: Distrobox does not run natively on macOS. While you can run DbxSmith inside a Linux VM on Mac, the host-integration features (like shared home paths) will be limited to the VM environment.
💡 PREREQUISITES
DbxSmith requires Linux, Distrobox, and Podman. If Distrobox is missing on your Linux host, the installer will detect this and offer to set it up automatically.