A debug container for Kubernetes. Because kubectl exec into an alpine container with nothing but sh is not fun.

This project was created out of a need for a user-like zsh/bash shell for testing https://github.com/jessegoodier/kpf completions.

The best way to use this is with the main combined image, which includes tools for all three major clouds:

kubectl run debug --rm -it --image=ghcr.io/jessegoodier/toolbox -- zsh

Main image (toolbox):

• All common tools (see below)
• AWS CLI
• Google Cloud SDK (gcloud, gsutil)
• Azure CLI (az)

Common base image (toolbox-common):

• openssl, kubectl, curl, wget, jq, yq
• dig, nslookup, doggo, mtr, ping, netcat, tcpdump
• htop, strace, lsof, ps
• ripgrep, rclone, tree, less, file
• fzf, fd, eza
• neovim, git
• bash + zsh with completions, syntax highlighting, autosuggestions
• Python 3.14 + uv

Cloud-specific images (lighter alternatives):

• toolbox-aws - AWS CLI only
• toolbox-gcp - Google Cloud SDK only
• toolbox-azure - Azure CLI only

All images are multi-arch (amd64/arm64) and rebuilt daily.

# All-in-one (Recommended)
kubectl run debug --rm -it --image=ghcr.io/jessegoodier/toolbox -- zsh

# Specific cloud provider
kubectl run debug --rm -it --image=ghcr.io/jessegoodier/toolbox-aws -- zsh

# Minimal (Common tools only)
kubectl run debug --rm -it --image=ghcr.io/jessegoodier/toolbox-common -- zsh

# Dry run (no push)
./build_images.sh

# Push to registry
PUSH=true ./build_images.sh

Do whatever you want with it. If it breaks your cluster, you get to keep both pieces.