# Install ocm with Homebrew, Nix

CLI for the Red Hat OpenShift Cluster Manager. Version 1.0.15 via Homebrew; verified 2026-06-21.

## Install

```sh
sudo av install brew:ocm
```

Additional install commands:

### macOS

- Homebrew (100%):

```sh
brew install ocm
```

  Evidence: local Homebrew formula metadata

### Linux

- Nix (92%):

```sh
nix profile install nixpkgs#ocm
```

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

## Package facts

- **Package key:** brew:ocm
- **Package manager:** Homebrew
- **Package manager page:** <https://formulae.brew.sh/formula/ocm>
- **Version:** 1.0.15
- **Source summary:** CLI for the Red Hat OpenShift Cluster Manager
- **Homepage:** <https://www.openshift.com/>
- **Repository:** <https://github.com/openshift-online/ocm-cli>
- **Upstream docs:** <https://docs.redhat.com/en/documentation/openshift_cluster_manager/2022/html/managing_clusters/using-ocm-ocm-cli_assembly-what-is-ocm>
- **License:** Apache-2.0
- **Source archive:** <https://github.com/openshift-online/ocm-cli/archive/refs/tags/v1.0.15.tar.gz>
- **Last updated:** 2026-06-21T23:25:22+02:00
- **Generated:** 2026-07-09T07:20:21+00:00

## Executables

- ocm (cli)
- ocm (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-09
- Package-manager version: 1.0.15
- Package-manager updated: 2026-06-21
- Local data: ok
- Upstream repository: https://github.com/openshift-online/ocm-cli
- Upstream latest detected: v1.0.15 (current)
## Project history and usage

OCM CLI is the command-line client for Red Hat OpenShift Cluster Manager. It gives administrators and automation scripts a direct interface to the OCM API at api.openshift.com.

### Project history

The upstream openshift-online/ocm-cli README describes the project as command-line tools that simplify use of the OCM API. It is written and distributed as a Go CLI, with installation paths through Fedora/CentOS Copr packages, Homebrew, GitHub release binaries, and Go tooling.

The CLI follows the service model of OpenShift Cluster Manager: a managed service on Red Hat Hybrid Cloud Console used to create, operate, and upgrade OpenShift clusters. Red Hat documentation positions OCM as a unified dashboard for OpenShift Container Platform, OpenShift Dedicated, and Red Hat OpenShift Service on AWS cluster workflows.

The CLI evolved around authenticated API access. Its README documents offline access token login, OpenID token exchange through sso.redhat.com, per-user configuration files, `OCM_CONFIG` for multiple concurrent logins, keyring storage, opaque-token support, and raw API-style `get` requests.

### Adoption history

OCM CLI adoption is tied to Red Hat OpenShift operations rather than general Kubernetes administration. It complements the OpenShift `oc` CLI: `oc` manages cluster and application resources, while `ocm` speaks to Red Hat's cluster-manager APIs for subscription, fleet, and managed-cluster workflows.

Homebrew's formula API generated on 2026-07-01 lists stable version 1.0.15 and 620 installs over 365 days. The README's Fedora/CentOS Copr path and release-binary installation instructions show that Homebrew is only one of several distribution channels for OpenShift operators.

### How it is used

A user logs in with an OpenShift Cluster Manager offline token from console.redhat.com, after which credentials are stored in an OCM configuration file or supported OS keyring. Commands can then retrieve objects, query cluster collections, print tokens for use with curl, and interact with API resources under paths such as `/api/clusters_mgmt/v1/clusters`.

The CLI is especially useful for operators who need repeatable cluster-management tasks, support workflows, or scripting against api.openshift.com without manually driving the web console.

### Why package nerds care

OCM CLI is a vendor operations CLI with service-specific authentication, multiple native distribution channels, and a clean Homebrew formula. Its metadata helps distinguish Red Hat's cluster-manager API tooling from the separate OpenShift client binary `oc`.

### Timeline

- The README's installation example references release v0.1.30, reflecting the pre-1.0 release series used for binary distribution.
- Before version 0.1.56, the README says the configuration file used `~/.ocm.json`; later versions use platform-specific application configuration paths.
- 2026-07-01: Homebrew formula metadata lists stable version 1.0.15 and 620 installs over the previous 365-day analytics window.

### Related projects

- Related projects include Red Hat OpenShift Cluster Manager, the OCM API, openshift-online/ocm-sdk-go, openshift-online/ocm-api-model, Red Hat Hybrid Cloud Console, and the OpenShift `oc` client.

### Sources

- <https://api.openshift.com>
- <https://docs.redhat.com/en/documentation/openshift_cluster_manager/1-latest/html-single/managing_clusters/index>
- <https://formulae.brew.sh/api/formula/ocm.json>
- <https://github.com/openshift-online/ocm-api-model>
- <https://github.com/openshift-online/ocm-sdk-go>
- <https://raw.githubusercontent.com/openshift-online/ocm-cli/main/README.md>


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

- Linux: ~/.config/ocm/ocm.json
- macOS: ~/Library/Application Support/ocm/ocm.json

## Credential files

- Linux: ~/.config/ocm/ocm.json
- macOS: ~/Library/Application Support/ocm/ocm.json
## Source Database Details

- **Source Database:** Homebrew formula API
- **Tap:** homebrew/core
- **Full Name:** ocm
- **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 - ocm: normalized package name match | nixpkgs package indexes: pkgs/by-name/oc/ocm/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1


## Related links

- [Cloud CLI packages](https://www.automicvault.com/pkg/cloud-clis/) - Belongs to a cloud or infrastructure 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.
- [Networking and protocol packages](https://www.automicvault.com/pkg/networking-protocol-tools/) - Matched network, protocol, or remote-service metadata.
- [go](https://www.automicvault.com/pkg/brew/go/) - Build dependency declared by Homebrew.
- [openshift-cli](https://www.automicvault.com/pkg/brew/openshift-cli/) - Shares the same upstream homepage.
- [flintrock](https://www.automicvault.com/pkg/brew/flintrock/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management.
- [osdctl](https://www.automicvault.com/pkg/brew/osdctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes, openshift.
- [clusterctl](https://www.automicvault.com/pkg/brew/clusterctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes.
- [k9s](https://www.automicvault.com/pkg/brew/k9s/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes.
- [kops](https://www.automicvault.com/pkg/brew/kops/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes.
- [mcp-server-kubernetes](https://www.automicvault.com/pkg/brew/mcp-server-kubernetes/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes.
- [rancher-cli](https://www.automicvault.com/pkg/brew/rancher-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, cluster-management, kubernetes.
- [rosa-cli](https://www.automicvault.com/pkg/brew/rosa-cli/) - Local package facts share a topical domain. Shared terms: cli, cloud, cloud-infrastructure, infrastructure, kubernetes.

## Combined YAML source

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