Installing the IBM® Cloud Private CLI

You can install and use the IBM Cloud Private command line interface (CLI) to manage one or multiple clusters.

After you install IBM Cloud Private, you can install the CLI on Windows™, Linux®, or macOS.

1. Expand Install IBM® Cloud Private CLI to download the installer by using a curl command. Copy and run the curl command for your operating system, then continue the installation procedure in the product documentation:

   Choose the curl command for the applicable operating system. For example, you can run the following command for macOS:

   curl -kLo <install_file> https://<cluster_name>:<port>/api/cli/cloudctl-darwin-amd64
   

2. After you run the curl command for your operating system, continue to install the IBM Cloud Private CLI.

   To install the IBM Cloud Private CLI, run the command that matches your client computer operating system, where <path_to_installer> is the path to the directory where you downloaded the CLI file, and <install_file> is the downloaded file name.

   • For Linux and macOS, run the following commands to change and move the file:

     chmod 755 <path_to_installer>/<install_file>
     

     sudo mv <path_to_installer>/<install_file> /usr/local/bin/cloudctl
     

   • For Windows, rename the downloaded file to cloudctl and place the file on the PATH environment variable.

3. Confirm that the IBM Cloud Private CLI is installed:

   cloudctl --help
   

   The IBM Cloud Private CLI usage is displayed.

4. Set up the kubectl CLI. See Installing the Kubernetes CLI (kubectl) for installation instructions.

5. Log in to your cluster with the following command, where cluster_host_name is the external host name or IP address for your master or leading master node.

   cloudctl login -a https://<cluster_host_name>:8443 --skip-ssl-validation
   

You can now use the IBM Cloud Private CLI to view information about your cluster and manage your clusters.