DbxSmith is a professional-grade provisioning, management, and orchestration suite built for Distrobox and Podman. It allows developers to forge isolated, high-performance container environments with strategic network control, a deterministic terminal TUI, and atomic bulk teardowns.
- ⚡ Async TUI Mission Control: A pure Bash, high-performance asynchronous terminal dashboard (
dbx-smith dash) with absolute zero-flicker rendering. - 🛡️ Host Identity Shielding (Ghost Boxes): ephemeral RAM-backed
tmpfsover-mounting of/hometo isolate host files and credentials perfectly. - 🌐 6 Strategic Isolation Levels: Pre-configured strategies including
standard,airgapped,isolated-net,ghost, and secure hybrids (ghost-airgapped,ghost-isolated-net). - 🎨 Visual Environment Anchoring: Deterministic background colors and dynamic container-specific
PS1/PROMPTinjection based on the active container image. - 🗑️ Zero-Drift Atomic Teardowns: Bulk destruction of containers, matching RAM directories, and virtual network NAT bridges with a single command (
--all).
Get up and running with a single command:
curl -fsSL https://raw.githubusercontent.com/arijit1begins/dbx-smith/main/install.sh | bashAlternatively, clone the repository locally and run:
make installForge and manage your containers instantly:
dbx-smith dashDisplay help info or list your active environments directly:
dbx-smith --help
dbx-smith listLaunch the interactive dashboard with dbx-smith dash and navigate like a pro:
| Key / Hotkey | Action | Description |
|---|---|---|
↑ / ↓ Arrow Keys |
Navigate | Browse through your local container environments. |
Enter |
Connect | Securely login and enter the selected container shell. |
+ |
Forge Wizard | Start a guided creation wizard with full back-navigation support. |
s |
Stop Box | Stops the selected container container background processes cleanly. |
r |
Destroy Box | Atomically deletes the container and its ephemeral assets. |
l |
Toggle Logs | Displays real-time background provisioning and setup logs. |
q |
Quit | Gracefully exits the TUI dashboard back to your host terminal. |
Clean up all active containers, ephemeral home directories, and custom virtual network bridges with a single atomic command:
dbx-smith-rm -a --purgeDbxSmith guarantees 100% stable integration across all 6 isolation strategies:
- 💻 Host OS Support: Any modern Linux distribution (Ubuntu, Fedora, Debian, Arch, Alpine, etc.)
- Note: macOS and Windows are not supported.
- 📦 Runtime Engines: Podman (Recommended), Distrobox, or Docker.
- 🐧 Supported Guest Distros: Alpine Linux, Arch Linux, Fedora, Ubuntu.
If you ever need to remove DbxSmith, clean up all system footprints atomically with:
dbx-smith-uninstall⚒️ Happy Forging!