# docker-ls を Homebrew, Nix でインストール

docker-ls のインストール経路、実行ファイル、メタデータ、AI エージェント向けセキュリティノートを確認します。

## インストール

```sh
sudo av install brew:docker-ls
```

追加のインストールコマンド:

### macOS

- Homebrew (100%):

```sh
brew install docker-ls
```

  証拠: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#docker-ls
```

  証拠: nixpkgs package indexes: pkgs/by-name/do/docker-ls/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

## パッケージ情報

- **パッケージキー:** brew:docker-ls
- **パッケージマネージャ:** Homebrew
- **バージョン:** 0.5.1
- **ソース概要:** Tools for browsing and manipulating docker registries
- **ホームページ:** <https://github.com/mayflower/docker-ls>
- **リポジトリ:** <https://github.com/mayflower/docker-ls>
- **最終更新:** 2026-07-28T14:10:41+02:00
- **生成日時:** 2026-08-03T19:37:03+00:00

## 実行可能ファイル

- docker-ls (エイリアス)
- docker-rm (エイリアス)

## インストール挙動

- Bottle: 利用不可

## バージョンと鮮度

- ページ生成日: 2026-08-03
- マネージャ版: 0.5.1
## プロジェクトの歴史と使われ方

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.

### プロジェクトの歴史

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.

### 採用の歴史

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.

### 使われ方

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.

### パッケージ好きにとっての重要性

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.

### タイムライン

- 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.

### ソース

- <https://github.com/mayflower/docker-ls#readme>
- <https://github.com/distribution/distribution>
- <https://docs.docker.com/registry/spec/auth/token/>


## セキュリティノート

narrow executable package without higher-risk signals.

- **Geiger リスク:** グリーン / 低
- 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|...]
## 他のパッケージマネージャ記録

- 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


## Combined YAML source

View the package source record on GitHub. [combined/docker-ls.yml](https://github.com/mxcl/pkgdb/blob/main/combined/docker-ls.yml)


## ソース

- pkg.so package database
- Geiger risk classifier
- curated configuration and credential file locations
- curated package history
- pkgdb category and tag curation
- external package-manager database matches
- cross-ecosystem install command graph