Command Line Interface (CLI)

The CLI is a small-footprint tool that you can use on its own or with the Console to complete Oracle Cloud Infrastructure tasks. The CLI provides the same core functionality as the Console, plus additional commands. Some of these, such as the ability to run scripts, extend Console functionality.


The CLI is pre-configured with your credentials and ready to use immediately from within Cloud Shell. For more information on using the CLI from within Cloud Shell, see Getting Started with Cloud Shell.

This CLI and sample is dual-licensed under the Universal Permissive License 1.0 and the Apache License 2.0; third-party content is separately licensed as described in the code.

The CLI is built on the Oracle Cloud Infrastructure SDK for Python and runs on Mac, Windows, or Linux. The Python code makes calls to Oracle Cloud Infrastructure APIs to provide the functionality implemented for the various services. These are REST APIs that use HTTPS requests and responses. For more information, see About the API.

Installation: See Quickstart.

Reference: For help with a specific command, you can enter help <command> on the command line or view the Command Line Reference. This reference is derived from the APIs and help text in the Python source code.


To install and use the CLI, you must have:

Supported Python Versions and Operating Systems

The CLI supports Python versions 3.6 and later running on MacOS, Windows, or supported Linux and UNIX-like operating systems:

  • Oracle Linux 6.10, Oracle Linux 7.7 and 7.8, and Oracle Linux 8.0
  • Oracle Autonomous Linux 7.8
  • CentOS 7.0 and CentOS 8.x
  • Ubuntu 16.04, Ubuntu 18.04, and Ubuntu 20.04

Python versions 2.7 and 3.5 are no longer maintained. Versions of the OCI CLI released after May 25th 2021 will not work with Python versions 2.7 or 3.5. Versions of the OCI CLI released before May 25th 2021 will continue to work with Python versions 2.7 and 3.5.

Newer versions of Python may not be immediately supported. The CLI might work on unlisted operating systems, but we do not test them for compatibility.

If you use the CLI installer and do not have Python on your machine, the installer offers to automatically install Python for you. If you already have Python installed on your machine, you can use the python --version command to find out which version is installed.

Services Supported

  • Analytics Cloud
  • Announcements
  • API Gateway
  • Application Migration
  • Application Performance Monitoring
  • Audit
  • Autoscaling (Compute)
  • Big Data
  • Blockchain Platform
  • Budgets
  • Cloud Guard
  • Compute Instance Agent (Oracle Cloud Agent)
  • Container Engine for Kubernetes
  • Content and Experience
  • Core Services (Networking, Compute, Block Volume)
  • Data Catalog
  • Data Flow
  • Data Integration
  • Data Safe
  • Data Science
  • Data Transfer
  • Database
  • Database Management
  • Digital Assistant
  • DNS
  • Email Delivery
  • Events
  • Functions
  • File Storage
  • Golden Gate
  • Health Checks
  • IAM
  • Integration
  • Key Management (for the Vault service)
  • Limits
  • Load Balancing
  • Logging
  • Logging Analytics
  • Logging Search
  • Logging Ingestion
  • Management Agent Cloud
  • Management Dashboard
  • Marketplace
  • Monitoring
  • MySQL Database
  • Network Load Balancing
  • NoSQL Database Cloud
  • Notifications
  • Object Storage
  • OCI Registry
  • Organizations
  • Operations Insights
  • Optimizer
  • OS Management
  • Quotas
  • Resource Manager
  • Search
  • Secret Management (for the Vault service)
  • Secret Retrieval (for the Vault service)
  • Service Connector Hub
  • Streaming
  • Support Management
  • Usage
  • VMWare Solution
  • Web Application Acceleration and Security
  • Work Requests (Compute, Database)