DEV Community

Arijit Das
Arijit Das

Posted on

DbxSmith: Forge Isolated Dev Environments and Manage Boxes Seamlessly

#productivity #containers #linux #devex

A pure Bash TUI toolkit for provisioning, isolating, and orchestrating Distrobox/Podman containers — without the overhead.

GitHub logo 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

Unified Pipeline License Docs

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

DbxSmith Dashboard Showcase

🚀 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 tmpfs over-mounting of /home to 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/PROMPT injection based on the active container image.
  • 🗑️ Zero-Drift Atomic…
View on GitHub

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 

dbx-smith-spin [options] [strategy] [name] [image] [alias] [bindkey]
Enter fullscreen mode Exit fullscreen mode

🖥️ Manage via TUI Dashboard 

dbx-smith dash
Enter fullscreen mode Exit fullscreen mode

dbx-smith TUI dashboard showing multiple isolated containers with color-coded prompts

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-rm --purge my-box

# Nuke all managed resources atomically
dbx-smith-rm --all --purge
Enter fullscreen mode Exit fullscreen mode

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
Enter fullscreen mode Exit fullscreen mode

Then:

dbx-smith --help      # Explore CLI options
dbx-smith dash        # Launch the TUI dashboard
Enter fullscreen mode Exit fullscreen mode

Docs & Community

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.

Top comments (0)