macOS
Homebrewverified · 100%
brew install docker-debuglocal Homebrew formula metadata
brew / rank 7686
Install docker-debug with Homebrew
Use new container attach on already container go on debug. Version 0.7.11 via Homebrew; verified 2026-09-12.
install
Additional install commands
overview
Package summary
Use new container attach on already container go on debug
Project links
Commands and aliases
- docker-debug
history
Project history and usage
docker-debug is a small troubleshooting CLI that starts a new debug container joined to a running target container's namespaces, allowing tools to be supplied from a separate image instead of being baked into the production image.
Project history
The README presents docker-debug as inspired by kubectl-debug and aimed at inspecting running Docker containers by joining PID, network, user, filesystem, and IPC namespaces. It uses nicolaka/netshoot as the default debug image and supports overriding behavior with flags or a local TOML config file.
The changelog shows rapid development in 2019 around mounting filesystems and volumes, adding a Homebrew install path, default config from environment, and config version management. Later entries are sparse, with v0.7.4 in 2022 documenting Docker client-version work and volume path handling.
Adoption history
Evidence for broad adoption is thin. The project documents Homebrew and binary-release installation, but the upstream materials mostly frame it as a focused utility for users who want Kubernetes-style ephemeral debugging against plain Docker containers.
How it is used
A typical invocation is docker-debug CONTAINER COMMAND. The tool creates a separate debug container, joins the target container's namespaces, mounts the target filesystem, runs the requested command, and then cleans up after the debug container exits.
Why package nerds care
docker-debug is interesting to package nerds because it packages an operations pattern rather than a large platform: ship debug tools separately, keep runtime images small, and use Linux namespaces to inspect a live workload. Its niche also makes it a good example of the long tail of Docker-era helper CLIs in Homebrew.
Timeline
- 2019: early v0.2.x-v0.6.x changelog entries add Homebrew installation, mounted filesystems, volume filesystem support, and config defaults.
- 2020: v0.7.x releases include config client-version and migration fixes.
- 2022: v0.7.4 documents Docker client-version work and volume path support.
Related projects
- The README names kubectl-debug as the inspiration, nicolaka/netshoot as the default debug image, and Docker Engine API documentation as a reference.
Sources
security posture
Risk level: orange
infrastructure mutation or orchestration signal.
Risk classifier
orange risk · medium confidence · infrastructure
Why
- infrastructure mutation or orchestration signal
Signals
- text:container
Install behavior
- No Homebrew post-install hook is recorded in formula metadata.
- Homebrew bottle metadata is available for 6 platform targets.
- Build metadata lists 1 build dependencies.
Recommended review
Before unattended agent use, check whether the tool reads plaintext credentials, writes remote state, publishes artifacts, or shells out to plugins.
local files
Configuration and credential file locations
These source-backed paths show where this package keeps local settings or durable credentials. Automic Vault can use them as review targets for secret scanning, migration, and command approval.
Configuration files
Config paths the tool may read or write during local use.
- Unix
~/.docker-debug/config.toml
executables
Installed executables
| Command | Kind | Exposure | Note |
|---|---|---|---|
docker-debug | cli | global executable |
freshness
Version and freshness
These signals separate page generation age, package-manager activity, and upstream release comparison. Version lag is warned only when an evidence URL and comparable versions are present.
page generated2026-09-19
manager version0.7.11
manager updated2026-09-12
local dataok
upstreamcurrent
latest detectedv0.7.11
https://github.com/zeromake/docker-debug
- okNo freshness warnings were generated.
install metadata
Package metadata
| Package key | brew:docker-debug |
|---|---|
| Version | 0.7.11 |
| Package manager | Homebrew |
| Package manager page | https://formulae.brew.sh/formula/docker-debug |
| Homepage | https://github.com/zeromake/docker-debug |
| Repository | https://github.com/zeromake/docker-debug |
| License | MIT |
| Source archive | https://github.com/zeromake/docker-debug/archive/refs/tags/v0.7.11.tar.gz |
| Last updated | 2026-09-12T22:11:03Z |
| Pulse | updated |
| Build dependencies | go |
| Bottle | available (on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux) |
| Homebrew post-install | not defined |
| Service | none declared |
registry facts
Source database details
| Source Database | Homebrew formula API |
|---|---|
| Tap | homebrew/core |
| Full Name | docker-debug |
| Version Scheme | 0 |
| Revision | 0 |
| Head Version | HEAD |
| Bottle Stable Root URL | https://ghcr.io/v2/homebrew/core |
| Deprecated | no |
| Disabled | no |
| Keg Only | no |
| URL Keys |
|
source trail
Generated from repository data
This page is generated by av-web from the private package SQLite artifact built by scripts/generate-pkg-sqlite.py.
Combined YAML source
View the package source record on GitHub.
Used sources
- Geiger risk classifier
- cross-ecosystem install command graph
- curated configuration and credential file locations
- curated package history
- package relationship graph
- package version freshness
- package-page enrichment
- pkg.so package database
- pkgdb category and tag curation