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

OpenShift command-line interface tools. Version 4.22.6 via Homebrew; verified 2026-07-29. Also installable with chocolatey: choco install openshift-cli.

## 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/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-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','openconnect-gui'

## Package facts

- **Package key:** brew:openshift-cli
- **Package manager:** Homebrew
- **Version:** 4.22.6
- **Source summary:** OpenShift command-line interface tools
- **Homepage:** <https://www.openshift.com/>
- **Repository:** <https://github.com/openshift/oc>
- **Last updated:** 2026-07-29T00:17:35Z
- **Generated:** 2026-08-03T19:37:03+00:00

## Executables

- oc (alias)

## Install behavior

- Bottle: not available

## Freshness

- Page generated: 2026-08-03
- Package-manager version: 4.22.6
## 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
## 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','openconnect-gui'
- 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.22.0-1.3: installed executable or alias match | openSUSE Tumbleweed package metadata: oc from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Openshift / OKD Client CLI | https://github.com/openshift/oc
- zypper - oc-bash-completion - 4.22.0-1.3: installed executable or alias match | openSUSE Tumbleweed package metadata: oc-bash-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Bash Completion for oc | https://github.com/openshift/oc
- zypper - oc-fish-completion - 4.22.0-1.3: installed executable or alias match | openSUSE Tumbleweed package metadata: oc-fish-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Fish Completion for oc | https://github.com/openshift/oc
- zypper - oc-zsh-completion - 4.22.0-1.3: installed executable or alias match | openSUSE Tumbleweed package metadata: oc-zsh-completion from https://download.opensuse.org/tumbleweed/repo/oss/repodata/50b07339cb64c8ed4091bdbabddadc1ff5737b090e478818a195b40d8a3292861a879139b4a3987c31109699fde9fbf4a716367ddf4eef77da75f96e3193d6ed-primary.xml.zst | Zsh Completion for oc | https://github.com/openshift/oc


## Combined YAML source

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


## Sources

- 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