2019-03-11 20:59:48 -04:00
// Module included in the following assemblies:
//
2019-10-02 11:30:49 -04:00
// * cli_reference/openshift_cli/getting-started.adoc
2019-12-10 14:21:26 -05:00
// * installing/installing_aws/installing-aws-user-infra.adoc
2019-10-03 13:05:34 -04:00
// * installing/installing_aws/installing-aws-customizations.adoc
// * installing/installing_aws/installing-aws-default.adoc
// * installing/installing_aws/installing-aws-network-customizations.adoc
2019-11-07 13:56:52 -05:00
// * installing/installing_aws/installing-aws-private.adoc
2019-11-08 15:26:26 -05:00
// * installing/installing_aws/installing-aws-vpc.adoc
2019-10-03 13:05:34 -04:00
// * installing/installing_azure/installing-azure-customizations.adoc
// * installing/installing_azure/installing-azure-default.adoc
2019-11-22 08:24:58 -05:00
// * installing/installing_azure/installing-azure-private.adoc
2019-11-15 08:50:08 -05:00
// * installing/installing_azure/installing-azure-vnet.adoc
2020-01-30 14:13:19 -05:00
// * installing/installing_azure/installing-azure-user-infra.adoc
2019-10-03 13:05:34 -04:00
// * installing/installing_bare_metal/installing-bare-metal.adoc
// * installing/installing_gcp/installing-gcp-customizations.adoc
2019-11-07 13:56:52 -05:00
// * installing/installing_gcp/installing-gcp-private.adoc
2019-10-03 13:05:34 -04:00
// * installing/installing_gcp/installing-gcp-default.adoc
2019-11-18 12:35:43 -05:00
// * installing/installing_gcp/installing-gcp-vpc.adoc
2019-12-10 14:21:26 -05:00
// * installing/installing_gcp/installing-gcp-user-infra.adoc
// * installing/install_config/installing-restricted-networks-preparations.adoc
2019-10-03 13:05:34 -04:00
// * installing/installing_vsphere/installing-vsphere.adoc
2019-11-28 12:41:35 +01:00
// * installing/installing_ibm_z/installing-ibm-z.adoc
2019-11-07 11:00:17 -05:00
// * openshift_images/samples-operator-alt-registry.adoc
2020-03-29 10:11:00 -04:00
// * installing/installing_rhv/installing-rhv-customizations.adoc
// * installing/installing_rhv/installing-rhv-default.adoc
2019-07-15 19:47:25 -04:00
//
// AMQ docs link to this; do not change anchor
2019-03-11 20:59:48 -04:00
2019-05-13 08:55:00 +10:00
[id="cli-installing-cli_{context}"]
2020-02-27 11:49:29 -05:00
= Installing the CLI by downloading the binary
2019-03-11 20:59:48 -04:00
You can install the CLI in order to interact with {product-title} using a
command-line interface.
2019-10-03 13:05:34 -04:00
[IMPORTANT]
====
If you installed an earlier version of `oc`, you cannot use it to complete all
2019-10-01 14:34:47 -04:00
of the commands in {product-title} {product-version}. Download and
2019-10-03 13:05:34 -04:00
install the new version of `oc`.
====
2019-03-11 20:59:48 -04:00
.Procedure
2020-03-28 12:02:37 +01:00
ifdef::openshift-origin[]
. Navigate to https://mirror.openshift.com/pub/openshift-v4/clients/oc/latest/ and choose the folder for your operating system
. Download `oc.tar.gz`
endif::[]
ifndef::openshift-origin[]
2019-11-05 11:34:00 -05:00
. From the link:https://cloud.redhat.com/openshift/install[Infrastructure Provider] page on the {cloud-redhat-com} site, navigate to the page for your installation type and
2019-06-04 11:03:08 -04:00
click *Download Command-line Tools*.
2020-03-28 12:02:37 +01:00
endif::[]
2019-03-11 20:59:48 -04:00
. Click the folder for your operating system and architecture and click the
compressed file.
2019-10-03 13:05:34 -04:00
+
[NOTE]
====
You can install `oc` on Linux, Windows, or macOS.
====
2019-03-11 20:59:48 -04:00
. Save the file to your file system.
. Extract the compressed file.
. Place it in a directory that is on your `PATH`.
After you install the CLI, it is available using the `oc` command:
----
$ oc <command>
----