dansharpy/debug repository overview

A homelab / Kubernetes diagnostics toolbox, built weekly and pushed to dansharpy/debug on Docker Hub. Gitlab repo is https://gitlab.com/dansharpy/debug-docker-image⁠

⁠Installed tools

General / shell: bash, coreutils, git, curl, wget, unzip, tar, gzip, xz, less, vim, tree, htop, ncdu, bc

Scripting: python3, pip3

Database clients: sqlite3 (custom-built, .recover support), mysql (mariadb-client), psql (postgresql15-client), valkey-cli (redis-cli compatible)

Network / DNS: dig, nslookup, host (bind-tools), ping, traceroute, mtr, nmap, ncat, tcpdump, socat, ip, ss (iproute2), netstat (net-tools), iperf3, whois, openssl, doggo (modern DNS client)

Filesystem / disk / process: smartctl, lsblk, fdisk, blkid, parted (util-linux/e2fsprogs), lsof, strace, rsync, ps (procps)

Signing/verification: gpg

Kubernetes / cloud-native: kubectl, helm, etcdctl, etcdutl, stern, kubectx, kubens, jq, yq, crictl

⁠Running the image

Many of these tools need elevated privileges/host access to be useful (smartctl needs raw disk access, tcpdump needs NET_ADMIN/NET_RAW, etc.):

docker run --rm -it --network host --privileged \
  -v /dev:/dev \
  dansharpy/debug:latest

On Kubernetes, as an ephemeral debug/troubleshooting pod:

kubectl run debug --rm -it --image=dansharpy/debug:latest -- bash
# or attach into an existing node's namespaces:
kubectl debug node/<node-name> -it --image=dansharpy/debug:latest