pkg.sopackage field notes

brew / approval gates / rank 81

Install docker with Homebrew

Pack, ship and run any application as a lightweight container. Version 29.7.1 via Homebrew; verified 2026-07-31.

agent safety

Agent safety answer

docker controls containers, images, mounts, registries, and local build state that agents can use to reach host files.

Credential access

Reads Docker registry auth, mounted secrets, build args, and files exposed through volume mounts.

Remote mutation

Can push images, change containers, and alter running local or remote Docker contexts.

Publish/artifact risk

Can build and publish images that become production artifacts.

Recommended control

Gate image pushes, privileged containers, host mounts, and context changes.

Agent-use guidance

Allow local inspection and builds with constrained mounts; require approval for registry pushes and privileged execution.

install

Additional install commands

macOS

Homebrewverified · 100%
brew install docker

provider-native install command

overview

Package summary

Pack, ship and run any application as a lightweight container

Commands and aliases

  • docker

history

Project history and usage

Docker is the package that made container workflows a default part of developer tooling. The Homebrew docker formula installs the CLI, but the broader Docker project combines the command-line client, daemon, image format, registry workflows, Docker Hub, Docker Desktop, Compose, BuildKit, and related projects into the everyday vocabulary of build, ship, and run.

Project history

Docker's documentation defines Docker as an open platform for developing, shipping, and running applications, using containers as lightweight isolated environments. The docker/cli repository is the home of the Docker CLI, the command-line client that talks to the Docker daemon over the Docker API.

Docker's architecture joined a local client, a daemon, images, containers, registries, and distribution workflows into one approachable developer interface. Over time, major parts of the ecosystem were split or formalized into related projects such as Docker Distribution, containerd, runc, BuildKit, Compose, and Docker Desktop.

Adoption history

Docker spread because it made containerized development and CI/CD reproducible with ordinary commands such as docker build, run, pull, push, and compose-oriented workflows. Docker Hub provided the default public registry, and package managers made the CLI easy to install even on systems where the daemon or Desktop app came from a separate package.

The tool's adoption also reshaped packaging expectations. Application projects began shipping Dockerfiles, official images, compose files, and registry tags as part of their release surface. For many developers, installing docker became the practical entry point for running databases, language runtimes, build services, and whole application stacks locally.

How it is used

The docker command is the primary way many users interact with Docker. The client sends commands such as docker run to dockerd, which builds, runs, and distributes containers. Users pull and push images through registries, build images from Dockerfiles, inspect containers and images, manage networks and volumes, and configure CLI behavior in ~/.docker/config.json or through DOCKER_CONFIG.

Why package nerds care

For package nerds, docker is significant because it moved a large amount of software distribution from host-native packages to OCI-style images and registries. It also became a dependency of development workflows: a package manager entry for docker often means access to thousands of image-packaged tools rather than only one executable.

The CLI package is also interesting because it is only one face of Docker. On macOS, the standalone CLI, Docker Desktop, credential helpers, Compose, Buildx, and the daemon are related but not always delivered by the same package. That split makes docker a useful case study in how package managers model large developer platforms.

Timeline

  • 2013: Solomon Hykes first publicly demoed Docker at PyCon.
  • Docker platform era: The official architecture centers on a docker client, dockerd daemon, Docker API, images, containers, and registries.
  • CLI repository era: Docker CLI development lives in the docker/cli repository as the home of the command-line client.
  • 2023: Docker v23 made BuildKit the default builder for Linux images, with the legacy builder deprecated in Docker documentation.
  • 2026: Docker documentation still treats docker as the primary CLI for container lifecycle and registry workflows.

Related projects

  • Related projects include Docker Engine, Moby, containerd, runc, Docker Distribution, Docker Hub, Docker Desktop, Docker Compose, BuildKit, Buildx, and Docker credential helpers.

approval gates

Human review metadata for risky commands

The local approval-gate seed includes 6 rules for docker. Covered entrypoints: docker. Severity labels: critical, high. Coverage: partial, reviewed 2026-05-21.

Example gated actions

  • Store registry credentials.
  • Push an image to a registry.
  • Run a container with elevated host privileges.
  • Mount host paths into a container.
  • Force-remove containers, images, volumes, networks, or system data.
  • Execute a command inside a running container.

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/config.json

Credential files

Credential-bearing paths to review before unattended agent runs.

Unix
~/.docker/config.json

executables

Installed executables

CommandKindExposureNote
dockerexecutableindexed executableDiscovered from the local executable index.

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-08-03
manager version29.7.1
manager updated2026-07-31
local dataunknown
upstreamnot available
latest detectednot detected
  • okNo freshness warnings were generated.

install metadata

Package metadata

Package keybrew:docker
Version29.7.1
Package managerHomebrew
Homepagehttps://www.docker.com/
Repositoryhttps://github.com/docker/cli
Last updated2026-07-31T21:29:21Z
Pulseupdated
Bottlenot recorded
Servicenone declared

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.

Used sources

  • Geiger risk classifier
  • Nucleus package database
  • approval-gate seed metadata
  • curated agent safety answer
  • curated configuration and credential file locations
  • curated package history
  • pkgdb category and tag curation