40+ diagnostic tools (curl, dig, tcpdump, strace, nmap, jq) for Docker debugging
2.8K
All-in-one debugging toolkit for Docker containers. 40+ diagnostic tools in one image for when your production container has no shell, no curl, no nothing.
Your production container is distroless. It has no shell. A service is timing out and you can't even curl to test. You need dig to debug DNS, tcpdump to capture traffic, strace to trace syscalls — none of it is installed. Docker-debug gives you everything.
docker run -it --rm --network myapp_default zachbg/docker-debug:latest
docker run -it --rm --network container:myapp-web-1 zachbg/docker-debug:latest
docker run -it --rm --pid host zachbg/docker-debug:latest
debug shell # Interactive shell with all tools
debug net # Show network info (interfaces, routes, DNS)
debug net myhost # Full network diagnostics for a host
debug dns example.com # All DNS records
debug http https://api # HTTP timing + headers
debug port db:5432 # Test port connectivity
debug certs example.com # TLS certificate details
debug headers https:// # HTTP response headers
debug env # All environment variables
| Category | Tools |
|---|---|
| HTTP | curl, wget, grpcurl |
| DNS | dig, nslookup, host |
| Network | ping, traceroute, nmap, netcat, socat, ss, ip |
| Capture | tcpdump, ngrep |
| Process | htop, lsof, strace, ltrace, ps, procps |
| Data | jq, yq, vim, less |
| TLS | openssl |
| Docker | docker CLI |
| Database | redis-cli |
| System | file, tree, iptables, conntrack |
docker run -it --rm --network myapp_default zachbg/docker-debug:latest \
debug dns postgres
docker run -it --rm --network container:myapp-api-1 zachbg/docker-debug:latest \
tcpdump -i any -n port 8080
docker run -it --rm --network myapp_default zachbg/docker-debug:latest \
debug port postgres:5432
docker run --rm zachbg/docker-debug:latest debug certs api.example.com
docker run --rm zachbg/docker-debug:latest debug http https://api.example.com/health
docker run -it --rm --network myapp_default zachbg/docker-debug:latest \
redis-cli -h redis PING
services:
debug:
image: zachbg/docker-debug:latest
network_mode: "service:webapp"
stdin_open: true
tty: true
profiles: ["debug"] # Only start manually
# Usage: docker compose --profile debug run debug
Content type
Image
Digest
sha256:9a2865939…
Size
43.6 MB
Last updated
6 months ago
docker pull zachbg/docker-debug