ideaplexus/debug repository overview

⁠Debug Container

This is a very simple debug container based on alpine:3.24 which has an instance of supervisor running to ensure the container is kept running. You can get this container by running docker pull ideaplexus/debug.

It runs as the non-root user debug (uid/gid 99) with /debug as its working directory. The Dockerfile builds on linux/amd64 and linux/arm64; any other architecture fails the build with an explicit error.

⁠Included tools

• bash — shell, including bash-completion
• bind-tools — dig, nslookup, host
• coreutils — full GNU variants of the busybox utilities
• curl — HTTP client
• grpcurl — gRPC client
• jq — JSON processor
• nano — editor
• net-tools — netstat, ifconfig, route
• nmap — port scanner
• openldap-clients — ldapsearch, ldapwhoami
• openssh — ssh, scp, ssh-keygen
• yq — YAML processor
• supervisor — keeps the container running

Database clients:

• mariadb-client — mariadb (MySQL/MariaDB)
• postgresql18-client — psql, pg_dump
• redis — redis-cli
• valkey-cli — valkey-cli
• mssql-tools18 — sqlcmd, bcp (in /opt/mssql-tools18/bin, not on PATH)

⁠Development

• make lint — lint the Dockerfile with hadolint
• make build — build the image for the host architecture as ideaplexus/debug
• make all — lint and build

Cross-architecture builds go through a dedicated buildx builder, which make builder creates on demand (the other targets depend on it):

• make build-cross — build for all PLATFORMS and load the result into the local image store
• make push-cross — build for all PLATFORMS and push the multi-platform image
• make builder-clean — remove the buildx builder again

PLATFORMS defaults to linux/amd64,linux/arm64 and can be overridden, for example make build-cross PLATFORMS=linux/arm64.

Cross builds emulate the foreign architecture inside the builder, so no host setup is needed to build them. Loading a multi-platform image via make build-cross requires the containerd image store, and running a foreign-architecture image additionally requires binfmt handlers on the host (qemu-user-static and qemu-user-static-binfmt on Arch-based distributions).