DebugBox¶
A lightweight, variant-based debugging container suite for Kubernetes and Docker environments.
Choose exactly the right size for your debugging task — no bloat, no waiting.
| Variant | Size | Best For | Image |
|---|---|---|---|
| lite | ~14 MB | Network/DNS checks | ghcr.io/ibtisam-iq/debugbox:lite |
| balanced (default) | ~46 MB | Daily Kubernetes troubleshooting | ghcr.io/ibtisam-iq/debugbox |
| power | ~104 MB | Packet capture & deep forensics | ghcr.io/ibtisam-iq/debugbox:power |
Also available on Docker Hub: mibtisam/debugbox:*
Supports amd64 and arm64 (Apple Silicon, Graviton, Raspberry Pi) out of the box.
Quick Start¶
Debug a running pod in seconds:
kubectl debug my-pod -it --image=ghcr.io/ibtisam-iq/debugbox
Or launch a standalone session:
kubectl run debug --rm -it --image=ghcr.io/ibtisam-iq/debugbox --restart=Never
Now you're inside with curl, dig, tcpdump, vim, strace, and more.
→ Full quick start guide | Installation
Why DebugBox?¶
Modern pods often lack basic debugging tools. DebugBox gives you three focused variants so you only pull what you need.
14 MB for basic connectivity · 46 MB for daily debugging · 104 MB only when you need advanced forensics
Faster pulls. Faster debugging.
Explore the Docs¶
-
Getting Started First steps, installation, motivation
-
Variants Compare lite · balanced · power and choose the right one
-
Kubernetes Usage
kubectl debug, ephemeral containers, sidecar patterns -
Docker Usage Network namespace sharing, host inspection
-
Tooling Manifest Complete list of included tools per variant
-
Examples Real-world debugging scenarios
-
Security Reporting, scanning, design trade-offs
-
Development Build, test and scan locally
Ready to debug faster?
Start with Quick Start or choose your variant.
Built with ❤️ by @ibtisam-iq · MIT License