# Install openshift-cli with Homebrew, chocolatey, MacPorts, zypper

OpenShift command-line interface tools. Version 4.22.3 via Homebrew; verified 2026-07-07.

## Install

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

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install openshift-cli
```

  Evidence: local Homebrew formula metadata

- MacPorts (94%):

```sh
sudo port install oc
```

  Evidence: MacPorts ports tree: sysutils/oc/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1

### Linux

- zypper (92%):

```sh
sudo zypper install oc
```

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

### Windows

- Chocolatey (92%):

```sh
choco install openshift-cli
```

  Evidence: Chocolatey community package catalog: openshift-cli from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','office365homepremium'

## Package facts

- **Package key:** brew:openshift-cli
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/openshift-cli>
- **Version:** 4.22.3
- **Source summary:** OpenShift command-line interface tools
- **Homepage:** <https://www.openshift.com/>
- **Repository:** <https://github.com/openshift/oc>
- **Upstream docs:** <https://docs.redhat.com/en/documentation/openshift_container_platform/latest/html/cli_tools/openshift-cli-oc>
- **License:** Apache-2.0
- **Source archive:** <https://mirror.openshift.com/pub/openshift-v4/clients/ocp/4.22.3/openshift-client-src.tar.gz>
- **Last updated:** 2026-07-07T21:33:04Z
- **Generated:** 2026-07-08T07:18:31+00:00

## Executables

- oc (cli)
- oc (alias)

## Build dependencies

- go

## Uses from macOS

- krb5

## 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: 4.22.3
- Package-manager updated: 2026-07-07
- Local data: ok
- Upstream repository: https://www.openshift.com/
- info: Release/tag comparison is only available for GitHub repositories.
## Project history and usage

OpenShift CLI, installed as `oc`, is the command-line client for Red Hat OpenShift and OKD. It layers OpenShift-specific workflows on top of Kubernetes client behavior, so administrators and developers can manage clusters, projects, apps, builds, routes, and resources from a terminal.

### Project history

OpenShift began as Red Hat's platform-as-a-service effort before the Kubernetes era. Red Hat's 10-year retrospective says OpenShift existed as a beta public cloud service before the OpenShift 1.0 launch at AWS re:Invent 2012, and later evolved toward hybrid cloud and Kubernetes-based infrastructure.

`oc` became the everyday terminal interface for that platform. The `openshift/oc` repository describes it as the OpenShift command line, part of OKD, built on top of `kubectl` while adding commands that simplify interaction with an OpenShift cluster.

### Adoption history

Because OpenShift is sold, hosted, and supported across self-managed and managed environments, `oc` is distributed through Red Hat downloads, cluster web consoles, RPMs, Homebrew, and other package managers. Red Hat documentation explicitly treats it as the CLI for working directly with project source code, scripting operations, and managing projects when the web console is unavailable.

The OKD community documentation mirrors the same installation and usage flow, reflecting `oc`'s role across both the commercial OpenShift Container Platform and the community distribution.

### How it is used

Operators use `oc login`, `oc get`, `oc apply`, `oc adm`, and release/admin subcommands to inspect and change clusters. Developers use it to create projects, deploy applications, view logs, expose services, manage builds, and script OpenShift workflows.

The CLI reads the same kubeconfig-style credentials location used by Kubernetes clients, which lets it fit into the broader Kubernetes tooling ecosystem while still exposing OpenShift-specific commands such as project and app helpers.

### Why package nerds care

`oc` is a good example of a package whose name, executable, and upstream identity differ: Homebrew packages `openshift-cli`, the executable is `oc`, and the GitHub repository is `openshift/oc`. It also shows how Kubernetes platform vendors package a superset CLI rather than asking users to compose many separate tools.

### Timeline

- 2012: OpenShift 1.0 launched after an earlier beta public cloud service.
- 2018-08-03: Red Hat announced the OKD name for the OpenShift Origin community distribution.
- 2019-05-28: The public `openshift/oc` GitHub repository was created.
- OpenShift 4.x: Red Hat documentation packages `oc` as a standard CLI tool downloadable for Linux, Windows, macOS, RPM-based installs, and Homebrew.

### Related projects

- `oc` is closely related to Kubernetes `kubectl`, OKD, OpenShift Container Platform, OpenShift release tooling, and Red Hat's broader OpenShift managed-service offerings.

### Sources

- <https://api.github.com/repos/openshift/oc>
- <https://docs.okd.io/latest/cli_reference/openshift_cli/getting-started-cli.html>
- <https://docs.redhat.com/en/documentation/openshift_container_platform/4.11/html/cli_tools/openshift-cli-oc>
- <https://formulae.brew.sh/api/formula/openshift-cli.json>
- <https://formulae.brew.sh/formula/openshift-cli>
- <https://github.com/openshift/oc>
- <https://www.redhat.com/en/blog/okd310release>
- <https://www.redhat.com/en/blog/paas-kubernetes-cloud-services-looking-back-10-years-red-hat-openshift>


## Security Notes

No matching local secret-handling manifest was found for openshift-cli. 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.


## Credential files

- Unix: ${HOME}/.kube/config
- Windows: %USERPROFILE%\.kube\config
## Source Database Details

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

- Chocolatey - openshift-cli: normalized package name match | Chocolatey community package catalog: openshift-cli from http://community.chocolatey.org/api/v2/Packages?$filter=IsLatestVersion&$select=Id&$top=1000&$skiptoken='11','office365homepremium'
- MacPorts - oc: installed executable or alias match | MacPorts ports tree: sysutils/oc/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1
- zypper - oc - 4.21.0-1.4: installed executable or alias match | openSUSE Tumbleweed package metadata: oc from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Openshift / OKD Client CLI | https://github.com/openshift/oc
- zypper - oc-bash-completion - 4.21.0-1.4: installed executable or alias match | openSUSE Tumbleweed package metadata: oc-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Bash Completion for oc | https://github.com/openshift/oc
- zypper - oc-fish-completion - 4.21.0-1.4: installed executable or alias match | openSUSE Tumbleweed package metadata: oc-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Fish Completion for oc | https://github.com/openshift/oc
- zypper - oc-zsh-completion - 4.21.0-1.4: installed executable or alias match | openSUSE Tumbleweed package metadata: oc-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Zsh Completion for oc | https://github.com/openshift/oc


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure command family.
- [Terminal utility packages](https://www.automicvault.com/pkg/terminal-utilities/) - Matched terminal and command-line workflow metadata.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [Homebrew utility packages](https://www.automicvault.com/pkg/brew-utility-packages/) - Matched Homebrew package provider.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [ocm](https://www.automicvault.com/pkg/brew/ocm/) - Shares the same upstream homepage.
- [rosa-cli](https://www.automicvault.com/pkg/brew/rosa-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes, openshift.
- [cdk8s](https://www.automicvault.com/pkg/brew/cdk8s/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [chaoskube](https://www.automicvault.com/pkg/brew/chaoskube/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [click](https://www.automicvault.com/pkg/brew/click/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [cloud-provider-kind](https://www.automicvault.com/pkg/brew/cloud-provider-kind/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [clusterawsadm](https://www.automicvault.com/pkg/brew/clusterawsadm/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [clusterctl](https://www.automicvault.com/pkg/brew/clusterctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [cozyhr](https://www.automicvault.com/pkg/brew/cozyhr/) - Shares av.db curated category or tags: cli, cloud-infrastructure, kubernetes.
- [kn](https://www.automicvault.com/pkg/brew/kn/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, command-line, infrastructure.

## Combined YAML source

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