# Install oci-cli with Homebrew, apk, dnf, MacPorts, Nix, scoop, zypper Oracle Cloud Infrastructure CLI. Version 3.89.0 via Homebrew; verified 2026-07-01. ## Install ```sh sudo av install brew:oci-cli ``` ## Agent safety answer oci-cli controls Oracle Cloud resources and account state. - **Credential access:** Reads OCI config, API keys, tenancy data, and environment credentials. - **Remote mutation:** Can create, delete, or modify Oracle Cloud resources. - **Publish/artifact risk:** Can upload artifacts and deploy infrastructure changes. - **Recommended control:** Gate mutating oci commands and credential file access. - **Agent-use guidance:** Allow read-only listing; require approval for writes, deletes, and credential changes. Additional install commands: ### macOS - Homebrew (100%): ```sh brew install oci-cli ``` Evidence: local Homebrew formula metadata - MacPorts (94%): ```sh sudo port install oci-cli ``` Evidence: MacPorts ports tree: net/oci-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 ### Linux - apk (92%): ```sh sudo apk add oci-cli ``` Evidence: Alpine Linux edge package indexes: oci-cli from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz - dnf (92%): ```sh sudo dnf install oci-cli ``` Evidence: Fedora Rawhide package metadata: oci-cli from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst - Nix (92%): ```sh nix profile install nixpkgs#oci-cli ``` Evidence: nixpkgs package indexes: pkgs/by-name/oc/oci-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - zypper (92%): ```sh sudo zypper install oci-cli ``` Evidence: openSUSE Tumbleweed package metadata: oci-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst ### Windows - Scoop (92%): ```sh scoop install main/oci-cli ``` Evidence: Scoop official bucket manifest trees: bucket/oci-cli.json from https://api.github.com/repos/ScoopInstaller/Main/git/trees/master?recursive=1 ## Package facts - **Package key:** brew:oci-cli - **Package manager:** Homebrew - **Package manager page:** - **Version:** 3.89.0 - **Source summary:** Oracle Cloud Infrastructure CLI - **Homepage:** - **Repository:** - **Upstream docs:** - **License:** UPL-1.0 OR Apache-2.0 - **Source archive:** - **Last updated:** 2026-07-01T13:20:46Z - **Generated:** 2026-07-08T07:18:31+00:00 ## Executables - create_backup_from_onprem (cli) - oci (cli) - create_backup_from_onprem (alias) - oci (alias) ## Dependencies - certifi - cryptography - libyaml - python@3.14 ## 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: 3.89.0 - Package-manager updated: 2026-07-01 - Local data: ok - Upstream repository: https://docs.cloud.oracle.com/iaas/Content/API/Concepts/cliconcepts.htm - info: Release/tag comparison is only available for GitHub repositories. ## Project history and usage OCI CLI is Oracle's open source command-line interface for Oracle Cloud Infrastructure. It gives operators and developers a scriptable interface to OCI objects and services, covering the same core administrative surface as the web Console while adding command-line workflows such as automation and batch execution. ### Project history The upstream project is maintained by Oracle and distributed from the oracle/oci-cli repository. The README identifies it as the command-line interface for Oracle Cloud Infrastructure, with Oracle as maintainer and community contributions accepted through the public repository. The README copyright line covers 2016 and 2019, matching OCI CLI's role as part of Oracle's post-Oracle Cloud Infrastructure tooling generation. Later project evolution is visible in the repository's changelog and release stream, while Oracle documentation remains the canonical user-facing reference for installation, configuration, troubleshooting, and command documentation. The project expanded beyond a basic noninteractive command runner with interactive mode, shell guidance, suggestions, color-coded required and optional parameters, quick references, offline installation assets, and a container image published through GitHub Container Registry. ### Adoption history OCI CLI became a standard cross-platform entry point for OCI automation because Oracle documents installation paths for macOS, Linux, Oracle Linux, Fedora, and Windows, and because Homebrew packages it as `oci-cli` with the `oci` executable. Homebrew's formula API generated on 2026-07-01 reports 40,195 installs over 365 days and 11,792 installs over 90 days, showing sustained package-manager use outside Oracle's own installers. The same API lists binary bottles for macOS and Linux variants, making the package available to both workstation and automation environments. ### How it is used Users configure OCI credentials and profiles, then run `oci` commands to inspect and manage cloud resources. Oracle's documentation frames the tool as usable on its own or alongside the Console, and the README points users to example commands, help output, interactive mode, and troubleshooting documentation. The package matters operationally because cloud teams can place OCI actions in shell scripts, CI jobs, recovery procedures, and offline administrative environments. The container image path adds a reproducible way to run the CLI where installing Python dependencies directly is inconvenient. ### Why package nerds care For package cataloging, OCI CLI is a large vendor cloud CLI with its own release cadence, Python packaging lineage, OS-specific installers, Homebrew bottles, and a container distribution channel. It is also a useful example of a cloud provider CLI that straddles package managers, language packaging, and official documentation. ### Timeline - 2016: The repository license/copyright record begins in the same period as Oracle's public OCI tooling. - 2019: The README license line still names Oracle and the dual UPL-1.0 / Apache-2.0 licensing. - 2026-07-01: Homebrew formula metadata lists stable version 3.89.0 and 40,195 installs over the previous 365-day analytics window. ### Related projects - OCI CLI sits beside Oracle's OCI SDK documentation and configuration model, and its container image is published from Oracle's GitHub container packages. It also overlaps with helper projects and integrations that wrap or invoke the `oci` executable in CI and shell workflows. ### Sources - - - - - ## 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: ~/.oci/config - Windows: $Env:UserProfile\.oci\config ## Credential files - Unix: ~/.oci/oci_api_key.pem - Windows: %HOMEDRIVE%%HOMEPATH%\.oci\oci_api_key.pem ## Source Database Details - **Source Database:** Homebrew formula API - **Tap:** homebrew/core - **Full Name:** oci-cli - **Version Scheme:** 0 - **Revision:** 0 - **Head Version:** HEAD - **Bottle Stable Root URL:** - **Deprecated:** no - **Disabled:** no - **Keg Only:** no - **URL Keys:** head, stable ## Other Package-Manager Records - Nix - oci-cli: normalized package name match | nixpkgs package indexes: pkgs/by-name/oc/oci-cli/package.nix from https://api.github.com/repos/NixOS/nixpkgs/git/trees/master?recursive=1 - apk - oci-cli - 3.77.0-r0: normalized package name match | Alpine Linux edge package indexes: oci-cli from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Oracle Cloud Infrastructure CLI | https://docs.oracle.com/en-us/iaas/Content/API/Concepts/cliconcepts.htm - apk - oci-cli-pyc - 3.77.0-r0: normalized package name match | Alpine Linux edge package indexes: oci-cli-pyc from https://dl-cdn.alpinelinux.org/alpine/edge/community/x86_64/APKINDEX.tar.gz | Precompiled Python bytecode for oci-cli | https://docs.oracle.com/en-us/iaas/Content/API/Concepts/cliconcepts.htm - dnf - oci-cli - 3.85.0-2.fc45: normalized package name match | Fedora Rawhide package metadata: oci-cli from https://dl.fedoraproject.org/pub/fedora/linux/development/rawhide/Everything/x86_64/os/repodata/e5ca8ce900cd68f5419e1c39ae517343100b306336cbaeb70a3c153121d95094-primary.xml.zst | Command Line Interface for Oracle Cloud Infrastructure | https://github.com/oracle/oci-cli - zypper - oci-cli - 3.83.0-1.1: normalized package name match | openSUSE Tumbleweed package metadata: oci-cli from https://download.opensuse.org/tumbleweed/repo/oss/repodata/be8d3611d25469107f32075a1697e69ec57a2b850b42348a658cc671ad5ec2b50760d02c3e59524d50da9a11d5be799bdaffba2e166e8ca8858512e3c0bd665d-primary.xml.zst | Oracle Cloud Infrastructure CLI | https://docs.us-phoenix-1.oraclecloud.com/Content/API/SDKDocs/cli.htm - MacPorts - oci-cli: normalized package name match | MacPorts ports tree: net/oci-cli/Portfile from https://api.github.com/repos/macports/macports-ports/git/trees/master?recursive=1 - Scoop - main/oci-cli: normalized package name match | Scoop official bucket manifest trees: bucket/oci-cli.json from https://api.github.com/repos/ScoopInstaller/Main/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. - [python@3.14](https://www.automicvault.com/pkg/brew/python-3-14/) - Runtime dependency declared by Homebrew. - [hcloud](https://www.automicvault.com/pkg/brew/hcloud/) - Shares av.db curated category or tags: cli, cloud-cli, cloud-infrastructure, infrastructure. - [osc-cli](https://www.automicvault.com/pkg/brew/osc-cli/) - Shares av.db curated category or tags: cli, cloud-cli, cloud-infrastructure. - [ucloud](https://www.automicvault.com/pkg/brew/ucloud/) - Shares av.db curated category or tags: cli, cloud-cli, cloud-infrastructure. - [apko](https://www.automicvault.com/pkg/brew/apko/) - Shares av.db curated category or tags: cli, cloud-infrastructure, oci. - [bosh-cli](https://www.automicvault.com/pkg/brew/bosh-cli/) - Shares av.db curated category or tags: cli, cloud-infrastructure, infrastructure. - [clusterawsadm](https://www.automicvault.com/pkg/brew/clusterawsadm/) - Shares av.db curated category or tags: cli, cloud-infrastructure, infrastructure. - [clusterctl](https://www.automicvault.com/pkg/brew/clusterctl/) - Shares av.db curated category or tags: cli, cloud-infrastructure, infrastructure. - [container](https://www.automicvault.com/pkg/brew/container/) - Shares av.db curated category or tags: cli, cloud-infrastructure, oci. - [rockcraft](https://www.automicvault.com/pkg/brew/rockcraft/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, cloud, cloud-infrastructure, create. - [ansible](https://www.automicvault.com/pkg/brew/ansible/) - Both packages touch the same language runtime or ecosystem. Shared terms: certifi, cli, cloud, cloud-infrastructure, cryptography. ## Combined YAML source View the package source record on GitHub. [combined/oci-cli.yml](https://github.com/automic-vault/db/blob/main/combined/oci-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 - curated agent safety answer