A pure Bash TUI toolkit for provisioning, isolating, and orchestrating Distrobox/Podman containers — without the overhead.
arijit1begins
/
dbx-smith
DbxSmith - A professional-grade provisioning and management suite for Distrobox and Podman. Forge isolated developer environments with strategic network control, deterministic UI, and atomic teardowns.
⚒️ DbxSmith
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.
🌐 Quick Navigation
🚀 Key Features
-
⚡ 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…
The Problem I Was Solving
I needed to:
- Spin up isolated dev environments quickly (different distros, dependencies, network policies)
- Keep host and container identities cleanly separated
- Switch between 5+ boxes without losing context
- Tear everything down cleanly when done
Existing tools helped, but none gave me seamless management + strategic isolation in a single, scriptable interface. So I built dbx-smith.
What Is dbx-smith?
dbx-smith is a lightweight, pure Bash CLI + TUI dashboard that lets you:
- ✅ Forge new Distrobox containers with deterministic config
- ✅ Apply isolation strategies (network, ephemeral home, airgapped)
- ✅ Navigate, connect, and monitor boxes via a zero-flicker async TUI
- ✅ Destroy environments atomically — no orphaned volumes or bridges
No Node.js, no Python, no Go. Just Bash, Podman/Distrobox, and your terminal.
Core Workflows
🔧 Forge a New Box
# Standard isolated environment
dbx-smith spin --distro fedora --isolation standard
# Airgapped + ephemeral home (for security testing)
dbx-smith spin --distro alpine --isolation ghost-airgapped
# Custom network bridge
dbx-smith spin --distro ubuntu --isolation isolated-net --net-bridge dev-lab
🖥️ Manage via TUI Dashboard
dbx-smith dash
Then use intuitive controls:
| Key | Action |
|---|---|
↑/↓
|
Navigate boxes |
Enter |
Connect to selected box |
+ |
Launch forge wizard |
s / r
|
Stop or destroy box |
l |
Toggle live logs |
q |
Exit dashboard |
🧹 Clean Teardown
# Remove a single box
dbx-smith spin --remove my-box
# Nuke all managed resources atomically
dbx-smith spin --remove-all
Isolation Strategies (Pick Your Posture)
| Strategy | Use Case |
|---|---|
standard |
Balanced isolation for daily dev |
isolated-net |
Custom NAT bridges for service mesh testing |
ghost |
Ephemeral /home (tmpfs) — zero host leakage |
airgapped |
No network access — safe malware analysis |
ghost-airgapped |
Ephemeral + offline — maximum containment |
ghost-isolated-net |
Ephemeral home + custom bridge — hybrid testing |
All strategies are applied at provisioning time and enforced by Podman/Distrobox primitives — no runtime hacks.
Why Pure Bash?
- 🐚 Portability: Runs wherever Bash 4.0+ and Podman exist
- ⚡ Performance: Sub-millisecond startup, zero external deps
- 🔍 Transparency: Every operation is readable, auditable shell
- 🛠️ Extensibility: Drop in your own plugins or wrappers
The entire codebase is ~97% Bash. No transpilation. No bundlers. Just #!/usr/bin/env bash.
Real-World Scenarios
✅ Multi-distro feature testing
Spin up Alpine, Arch, Fedora, and Ubuntu side-by-side. Test your script or app across environments without polluting your host.
✅ Security research sandboxing
Use ghost-airgapped to analyze untrusted code: no network, no persistent home, no host credential exposure.
✅ CI/CD local validation
Reproduce CI environments locally with identical isolation policies. Tear down cleanly after each test cycle.
✅ Context switching for polyglot devs
Work on a Rust project in Fedora, a Python service in Ubuntu, and a shell script in Alpine — all isolated, all instantly accessible via the TUI.
Installation
curl -fsSL https://raw.githubusercontent.com/arijit1begins/dbx-smith/main/install.sh | bash
Then:
dbx-smith --help # Explore CLI options
dbx-smith dash # Launch the TUI dashboard
Docs & Community
- 📖 Documentation: https://arijit1begins.github.io/dbx-smith/
- 💻 Source & Issues: https://github.com/arijit1begins/dbx-smith
- 📰 Engineering Notes: https://arijit1begins.github.io/dbx-smith/blog
Licensed under Apache 2.0. Contributions welcome.
💬 Let's Discuss
How do you currently manage isolated dev environments? What isolation guarantees matter most to your workflow?
If dbx-smith aligns with your needs, consider starring the repo or trying it out. Built in public, for developers who value control and clarity.