# Install docker-credential-helper with Homebrew, zypper

Platform keystore credential helper for Docker. Version 0.9.8 via Homebrew; verified 2026-06-08.

## Install

```sh
sudo av install brew:docker-credential-helper
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install docker-credential-helper
```

  Evidence: local Homebrew formula metadata

### Linux

- zypper (92%):

```sh
sudo zypper install docker-credential-secretservice
```

  Evidence: openSUSE Tumbleweed package metadata: docker-credential-secretservice from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst

## Package facts

- **Package key:** brew:docker-credential-helper
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/docker-credential-helper>
- **Version:** 0.9.8
- **Source summary:** Platform keystore credential helper for Docker
- **Homepage:** <https://github.com/docker/docker-credential-helpers>
- **Repository:** <https://github.com/docker/docker-credential-helpers>
- **Upstream docs:** <https://github.com/docker/docker-credential-helpers#readme>
- **License:** MIT
- **Source archive:** <https://github.com/docker/docker-credential-helpers/archive/refs/tags/v0.9.8.tar.gz>
- **Last updated:** 2026-06-08T21:10:10Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- docker-credential-pass (cli)
- docker-credential-secretservice (cli)
- docker-credential-pass (alias)
- docker-credential-secretservice (alias)

## Build dependencies

- go
- pkgconf

## Install behavior

- Post-install hook: not defined
- Bottle: available on arm64_linux, arm64_sequoia, arm64_sonoma, arm64_tahoe, sonoma, x86_64_linux

## Freshness

- Page generated: 2026-07-08
- Package-manager version: 0.9.8
- Package-manager updated: 2026-06-08
- Local data: ok
- Upstream repository: https://github.com/docker/docker-credential-helpers
- Upstream latest detected: v0.9.8 (current)
## Project history and usage

Docker Credential Helpers is Docker's suite of helper binaries and Go libraries for storing registry credentials in native platform stores rather than plain Docker config JSON.

### Project history

The repository was created to house the helper programs that Docker can invoke through its credential-store protocol. The README describes helpers for macOS Keychain, Linux Secret Service, Windows Credential Manager, and pass, plus libraries for client applications and for implementing new helpers.

The tag history begins with v0.1.0 in 2016 and continues through the 2020s. Its development has stayed intentionally narrow: it maintains small platform-specific executables, a common credentials protocol with store/get/erase/list commands, and build/release machinery for distributing helper binaries.

### Adoption history

The helper suite became part of normal Docker desktop and CLI workflows because Docker config supports a credsStore setting in ~/.docker/config.json. Users often encounter it indirectly when Docker Desktop or a package manager installs docker-credential-osxkeychain, docker-credential-wincred, docker-credential-secretservice, or docker-credential-pass.

### How it is used

Users configure Docker with a credsStore value such as osxkeychain, secretservice, wincred, or pass. Docker then calls the corresponding docker-credential-* program to store, retrieve, erase, and list registry secrets. Other command-line applications can also call helpers through the Go client package documented by the project.

### Why package nerds care

This is a classic small package with outsized operational effect: it is not the Docker daemon, but it determines whether registry authentication is stored in a system keychain or leaks into config files. It also explains why Docker packages often need platform-specific credential-helper binaries alongside the main CLI.

### Timeline

- 2016: v0.1.0 tagged for the Docker credential helper suite.
- 2017: v0.5.x releases continue early helper development.
- 2022: v0.7.0 appears after a long 0.6.x line.
- 2024: v0.8.x releases continue maintenance of the helper binaries.
- 2026: v0.9.8 is tagged in the upstream repository.

### Related projects

- Related projects include Docker CLI and Docker Engine, platform credential stores such as macOS Keychain, Secret Service, Windows Credential Manager, and pass, and service-specific helpers such as Amazon ECR Docker Credential Helper.

### Sources

- <https://github.com/docker/docker-credential-helpers#readme>
- <https://github.com/docker/docker-credential-helpers/releases>
- <https://github.com/docker/docker-credential-helpers/tags>
- <https://docs.docker.com/reference/cli/docker/login/>


## Security Notes

No matching local secret-handling manifest was found for docker-credential-helper. Nucleus package metadata is still published here so future coverage has a stable package URL.



## 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/config.json
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** docker-credential-helper
- **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:** head, stable

## Other Package-Manager Records

- zypper - docker-credential-secretservice - 0.7.0-1.12: installed executable or alias match | openSUSE Tumbleweed package metadata: docker-credential-secretservice from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Leverage Docker credentials with libsecret | http://www.docker.io


## 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.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Text processing packages](https://www.automicvault.com/pkg/text-processing-tools/) - Matched text, document, or structured-data processing metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [pkgconf](https://www.automicvault.com/pkg/brew/pkgconf/) - Build dependency declared by Homebrew.
- [docker-credential-helper-ecr](https://www.automicvault.com/pkg/brew/docker-credential-helper-ecr/) - Shares av.db curated category or tags: cli, containers, credentials, developer-tools, docker.
- [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-debug](https://www.automicvault.com/pkg/brew/docker-debug/) - 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-credential-helper.yml](https://github.com/automic-vault/db/blob/main/combined/docker-credential-helper.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
