---
name: satellite-cli-install
title: Installing the CLI
description: You can use the following tools to manage your Satellite locations and clusters. While you can install a subset of the tools, the following tools are recommended.
last-updated: 2026-08-14
---

> ## Documentation Index
> The table of contents for this documentation set is at https://cloud.ibm.com/docs/satellite?format=markdown
> The index for all IBM Cloud docs is at: https://cloud.ibm.com/docs/llms.txt
> Use these files to discover more information as needed.

# Installing the CLI
{: #cli-install}


You can use the following tools to manage your Satellite locations and clusters. While you can install a subset of the tools, the following tools are recommended.
{: shortdesc}


## Understanding the CLI tools
{: #cli-understand}

| CLI | Description |
| --- | --- |
| `ibmcloud` | You can use the `ibmcloud` CLI for tasks such as to log in to your account, add users, and manage your catalog items. |
| `ks` plug-in | You can use the `ks` plug-in to create and manage clusters and to manage your Satellite resources. |
{: caption="Table 1: CLI tools" caption-side="bottom"}


## Running the installation command
{: #step1-install-idt}
{: step}

The latest version of the IBM Cloud CLI is installed when you run the command. As the CLI installs, keep an eye on the command line to authenticate as needed.

* For MacOS, run the following command:
   ```curl
   curl -fsSL https://clis.cloud.ibm.com/install/osx | sh
   ```
   {: codeblock}

* For Linux™, run the following command:
   ```curl
   curl -fsSL https://clis.cloud.ibm.com/install/linux | sh
   ```
   {: codeblock}

* For Windows™, run the following command in PowerShell as an administrator:
   ```curl
   iex (New-Object Net.WebClient).DownloadString('https://clis.cloud.ibm.com/install/powershell')
   ```
   {: codeblock}

   To open PowerShell, right-click the Windows™ PowerShell icon, and select **Run as administrator**.
   {: tip}

* For WSL2 on Windows™, run the following command:
   ```curl
   curl -fsSL https://clis.cloud.ibm.com/install/linux | sh
   ```

For more installation methods, see [IBM Cloud CLI](https://cloud.ibm.com/docs/cli?topic=cli-getting-started&format=markdown).

## Verifying the installation
{: #step2-verify-idt}
{: step}

To verify that the CLI was installed successfully, run the `help` command:
```text
ibmcloud help
```
{: codeblock}

The output lists the usage instructions, the current version, and the supported commands.

## Installing CLI plug-ins and tools
{: #step3-install-idt-manually}
{: step}

To manually install the CLI plug-ins and tools, see [Extending IBM Cloud CLI with plug-ins](https://cloud.ibm.com/docs/cli?topic=cli-plug-ins&format=markdown).


To install the `container-service` or `ks` plug-in, which includes all `ibmcloud sat` commands, run the following command.

```sh
ibmcloud plugin install ks
```
{: pre}