# Install docker-ls with Homebrew, Nix Tools for browsing and manipulating docker registries. Version 0.5.1 via Homebrew; verified from local package data. ## Install ```sh sudo av install brew:docker-ls ``` Additional install commands: ### macOS - Homebrew (100%): ```sh brew install docker-ls ``` Evidence: local Homebrew formula metadata ### Linux - Nix (92%): ```sh nix profile install nixpkgs#docker-ls ``` Evidence: nixpkgs package indexes: pkgs/by-name/do/docker-ls/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:docker-ls - **Package manager:** Homebrew - **Package manager page:** - **Version:** 0.5.1 - **Source summary:** Tools for browsing and manipulating docker registries - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** MIT - **Source archive:** - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - docker-ls (cli) - docker-rm (cli) - docker-ls (alias) - docker-rm (alias) ## Build dependencies - go ## Install behavior - Post-install hook: not defined - Bottle: available on arm64_big_sur, arm64_linux, arm64_monterey, arm64_sequoia, arm64_sonoma, arm64_tahoe, arm64_ventura, big_sur, catalina, monterey, sonoma, ventura ## Freshness - Page generated: 2026-07-08 - Package-manager version: 0.5.1 - Local data: ok - Upstream repository: https://github.com/mayflower/docker-ls - info: No package-manager update timestamp was available. - info: No cached GitHub release or tag data was available. ## Project history and usage docker-ls is a small Go command-line toolkit for browsing Docker Registry HTTP API v2 registries. Its package value is less about being a general Docker replacement and more about exposing registry-level details, especially tag lists, manifests, and sha256 content digests, that are useful when maintaining private registries or cleaning up old image tags. ### Project history The project presents itself as two CLI tools, docker-ls and docker-rm, centered on Docker registry browsing and tag manipulation. The README ties it to Docker Distribution/v2 registries, token authentication, OAuth2 credentials from docker login, basic auth, and Docker credential helpers, placing it in the ecosystem of registry operations rather than container runtime management. ### Adoption history Its README documents distribution through GitHub releases, Homebrew, Gentoo, NixOS, Arch AUR, Docker images, and Go source installation. That packaging spread is the main adoption signal: docker-ls became a convenience utility for users who wanted registry inspection from package managers instead of hand-written Registry API calls. ### How it is used Typical usage is listing repositories on a registry, listing tags for a repository, inspecting a tag's manifest, dumping raw manifests, parsing manifest history, and deleting tags through docker-rm. It can reuse credentials from docker login, target a custom registry with --registry, and output YAML, JSON, or configured templates. ### Why package nerds care For package maintainers and registry operators, docker-ls sits in the practical gap between the high-level docker CLI and the lower-level Registry API. It is notable because it packages registry inventory, manifest inspection, digest lookup, and deletion workflows into small executables that can be installed beside Docker. ### Timeline - Docker Registry v2 era: The project targets only v2 registries and the Docker Distribution API. - Package-manager adoption: The README documents Homebrew, Gentoo, NixOS, and Arch AUR installation paths. - Credential integration: The tool documents reuse of Docker credential stores and helpers for authenticated registries. ### Related projects - Related projects include Docker Distribution, Docker Hub, Docker credential helpers, the Docker CLI, and registry-cleanup scripts that operate directly against the Registry HTTP API. ### Sources - - - ## Security Notes narrow executable package without higher-risk signals. - **Geiger risk:** green / low - narrow executable package without higher-risk signals ## 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 - Unix: ~/.docker-ls.[yaml|json|toml|...] ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** docker-ls - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** yes - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - docker-ls: normalized package name match | nixpkgs package indexes: pkgs/by-name/do/docker-ls/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 ## Related links - [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family. - [Source-control packages](https://www.automicvault.com/pkg/source-control-tools/) - Belongs to a source-control command family. - [Package publisher tools](https://www.automicvault.com/pkg/package-publishers/) - Belongs to a package publishing or registry command family. - [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata. - [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew. - [cdebug](https://www.automicvault.com/pkg/brew/cdebug/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker. - [cekit](https://www.automicvault.com/pkg/brew/cekit/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker. - [devcontainer](https://www.automicvault.com/pkg/brew/devcontainer/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker. - [dockcheck](https://www.automicvault.com/pkg/brew/dockcheck/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker. - [docker](https://www.automicvault.com/pkg/brew/docker/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker. - [docker-buildx](https://www.automicvault.com/pkg/brew/docker-buildx/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker. - [docker-clean](https://www.automicvault.com/pkg/brew/docker-clean/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker. - [docker-compose](https://www.automicvault.com/pkg/brew/docker-compose/) - Shares av.db curated category or tags: cli, containers, developer-tools, docker. - [docker-credential-helper](https://www.automicvault.com/pkg/brew/docker-credential-helper/) - Package names and metadata indicate a similar tool family. Shared terms: cli, containers, developer, developer-tools, docker. - [docker-credential-helper-ecr](https://www.automicvault.com/pkg/brew/docker-credential-helper-ecr/) - Package names and metadata indicate a similar tool family. Shared terms: cli, containers, developer, developer-tools, docker. ## Combined YAML source View the package source record on GitHub. [combined/docker-ls.yml](https://github.com/automic-vault/db/blob/main/combined/docker-ls.yml) ## Sources - Nucleus package database - Geiger risk classifier - package-page enrichment - curated configuration and credential file locations - curated package history - package version freshness - av.db category and tag curation - package relationship graph - external package-manager database matches - cross-ecosystem install command graph