# Install harbor-cli with Homebrew, Nix, winget, zypper

CLI for Harbor container registry. Version 0.0.24 via Homebrew; verified 2026-07-07.

## Install

```sh
sudo av install brew:harbor-cli
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install harbor-cli
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#harbor-cli
```

  Evidence: nixpkgs package indexes: pkgs/by-name/ha/harbor-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1

- zypper (92%):

```sh
sudo zypper install harbor-cli
```

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

### Windows

- winget (92%):

```sh
winget install --id GoHarbor.Harbor -e
```

  Evidence: Windows Package Manager source index: GoHarbor.Harbor from https://cdn.winget.microsoft.com/cache/source.msix

## Package facts

- **Package key:** brew:harbor-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/harbor-cli>
- **Version:** 0.0.24
- **Source summary:** CLI for Harbor container registry
- **Homepage:** <https://github.com/goharbor/harbor-cli>
- **Repository:** <https://github.com/goharbor/harbor-cli>
- **Upstream docs:** <https://github.com/goharbor/harbor-cli#readme>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/goharbor/harbor-cli/archive/refs/tags/v0.0.24.tar.gz>
- **Last updated:** 2026-07-07T16:39:12Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- harbor (cli)
- harbor (alias)

## Build dependencies

- go

## 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.0.24
- Package-manager updated: 2026-07-07
- Local data: ok
- Upstream repository: https://github.com/goharbor/harbor-cli
- Upstream latest detected: v0.0.24 (current)
## Project history and usage

Harbor CLI is the command-line companion for Harbor, the CNCF graduated registry used to secure and manage container images and other artifacts. The CLI's history is best understood as part of Harbor's move from a registry server with a web UI and APIs into scriptable cloud-native operations.

### Project history

CNCF's Harbor project journey report says Daniel Jiang made Harbor's first commit on 2016-02-01, Harbor joined CNCF on 2018-07-31, and it reached graduated status on 2020-06-23. The Harbor homepage describes the project as an open source registry that secures artifacts with policies, role-based access control, scanning, and signing.

The Harbor CLI repository history begins in April 2023. Its README defines the CLI as an alternative to the Harbor WebUI and as a tool for scripting common repeatable Harbor tasks from a workstation or pipeline.

### Adoption history

Harbor's adoption came from enterprise and cloud-native needs around private registries, Kubernetes, Docker image distribution, vulnerability scanning, signing, replication, and policy enforcement. CNCF graduation gave the broader project a clear governance and ecosystem signal.

Harbor CLI adoption follows the automation need: once registry operations are part of CI/CD and platform engineering workflows, a package-manager-installable `harbor` command is easier to script than a browser session.

### How it is used

The CLI manages Harbor resources such as projects, repositories, artifacts, labels, tags, quotas, webhooks, robot accounts, users, registries, replication, scanners, schedules, health, and CLI config.

It stores configuration and login-related material under the Harbor CLI config location, with environment variables available for containerized or scripted use.

### Why package nerds care

Harbor CLI is package-nerd relevant because it brings a cloud service administration surface into local package managers. A small CLI package becomes the reproducible interface between laptops, CI runners, and Harbor registries.

The package also carries the usual Go CLI concerns: static binaries, shell completion, config paths, credential handling, release artifacts, and platform-specific bottles or packages.

### Timeline

- 2016-02-01: CNCF reports the first Harbor commit.
- 2018-07-31: Harbor joins CNCF.
- 2020-06-23: Harbor reaches CNCF graduated status.
- 2023-04-23: Harbor CLI repository history begins with an initial commit.
- 2024-10-29: Official git tag history includes v0.0.1-era release pipeline work.

### Related projects

- Related projects include Harbor, Docker Distribution, Kubernetes, Helm, Notary-style signing workflows, vulnerability scanners, OCI artifacts, and CNCF cloud-native tooling.
- The CLI is also adjacent to API automation and CI/CD systems that need non-interactive registry administration.

### Sources

- <https://github.com/goharbor/harbor-cli>
- <https://goharbor.io/>
- <https://goharbor.io/cli-docs/>
- <https://www.cncf.io/reports/harbor-project-journey-report/>


## Security Notes

infrastructure mutation or orchestration signal.

- **Geiger risk:** orange / medium
- infrastructure mutation or orchestration signal


## 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: $HARBOR_CLI_CONFIG, $XDG_CONFIG_HOME/harbor-cli/config.yaml, ~/.config/harbor-cli/config.yaml

## Credential files

- Unix: $HARBOR_CLI_CONFIG, $XDG_CONFIG_HOME/harbor-cli/config.yaml, ~/.config/harbor-cli/config.yaml
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** harbor-cli
- **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

- Nix - harbor-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/ha/harbor-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1
- zypper - harbor-cli - 0.0.22-1.1: normalized package name match | openSUSE Tumbleweed package metadata: harbor-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | CLI for the Harbor cloud native registry | https://github.com/harbor/harbor-cli
- zypper - harbor-cli-bash-completion - 0.0.22-1.1: normalized package name match | openSUSE Tumbleweed package metadata: harbor-cli-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Bash Completion for harbor-cli | https://github.com/harbor/harbor-cli
- zypper - harbor-cli-fish-completion - 0.0.22-1.1: normalized package name match | openSUSE Tumbleweed package metadata: harbor-cli-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Fish Completion for harbor-cli | https://github.com/harbor/harbor-cli
- zypper - harbor-cli-zsh-completion - 0.0.22-1.1: normalized package name match | openSUSE Tumbleweed package metadata: harbor-cli-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Zsh Completion for harbor-cli | https://github.com/harbor/harbor-cli
- winget - GoHarbor.Harbor: normalized package name match | Windows Package Manager source index: GoHarbor.Harbor from https://cdn.winget.microsoft.com/cache/source.msix
- winget - IvanCharapanau.Harbor: installed executable or alias match | Windows Package Manager source index: IvanCharapanau.Harbor from https://cdn.winget.microsoft.com/cache/source.msix


## 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.
- [Secret-risk packages](https://www.automicvault.com/pkg/secret-risk-packages/) - Has protected-tool coverage, approval-gate, or non-low Geiger security signals.
- [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.
- [crane](https://www.automicvault.com/pkg/brew/crane/) - Shares av.db curated category or tags: cli, cloud-infrastructure, container-registry, containers, go.
- [hub-tool](https://www.automicvault.com/pkg/brew/hub-tool/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, registry.
- [ko](https://www.automicvault.com/pkg/brew/ko/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers, go.
- [amazon-ecs-cli](https://www.automicvault.com/pkg/brew/amazon-ecs-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers.
- [ansible-builder](https://www.automicvault.com/pkg/brew/ansible-builder/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers.
- [colima](https://www.automicvault.com/pkg/brew/colima/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers.
- [container](https://www.automicvault.com/pkg/brew/container/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers.
- [container-canary](https://www.automicvault.com/pkg/brew/container-canary/) - Shares av.db curated category or tags: cli, cloud-infrastructure, containers.

## Combined YAML source

View the package source record on GitHub. [combined/harbor-cli.yml](https://github.com/automic-vault/db/blob/main/combined/harbor-cli.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
