> ## Documentation Index
> Fetch the complete documentation index at: https://developers.stellar.org/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the Stellar CLI

> How to Install the Stellar CLI.

### Stellar CLI

There are a few ways to install the latest released version of Stellar CLI.

Install with script (macOS, Linux, WSL):

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
curl -fsSL https://github.com/stellar/stellar-cli/raw/main/install.sh | sh
```

Install with Homebrew (macOS, Linux, WSL):

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
brew install stellar-cli
```

Install with winget (Windows):

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
winget install --id Stellar.StellarCLI
```

Install with cargo from source ([github.com/stellar/stellar-cli](https://github.com/stellar/stellar-cli)):

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
cargo install --locked stellar-cli
```

> [!NOTE]
>
> Installing from source requires Rust and C build systems.
>
> To install Rust, see:
>
> * [https://www.rust-lang.org/tools/install](https://www.rust-lang.org/tools/install)
>
> To install a C build system on Debian/Ubuntu, use:
>
> ```
> sudo apt update && sudo apt install -y build-essential
> ```

Install in your GitHub action (this is a preferred option of installing cli in your GitHub actions)

```yaml theme={"theme":{"light":"github-light","dark":"github-dark"}}
uses: stellar/stellar-cli@v25.2.0
```

> [!NOTE]
>
> You can also use the third-party tool [SVM (Stellar Version Manager)](https://www.npmjs.com/package/svm-cli), a version manager for Stellar CLI that allows you to install and switch between different versions of stellar-cli.

## Set up Autocomplete

The Stellar CLI supports some autocompletion. To set up, run the following commands:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
stellar completion --shell <SHELL>
```

Possible SHELL values are `bash`, `elvish`, `fish`, `powershell`, `zsh`, etc.

To enable autocomplete in the current bash shell, run:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
source <(stellar completion --shell bash)
```

To enable autocomplete permanently, run:

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
echo "source <(stellar completion --shell bash)" >> ~/.bashrc
```

## Stellar CLI Cookbook

To understand how to get the most of the Stellar CLI, see the [Stellar CLI Cookbook](https://developers.stellar.org/docs/tools/cli/cookbook) for recipes and a collection of resources to teach you how to use the CLI. Examples of recipes included in the CLI cookbook include: send payments, manage contract lifecycle, extend contract instance/storage/wasm, and more.

## Video Tutorials

* Video Tutorial on `network container`, `keys`, and `contract init` from the [2024-06-27 developers meeting](https://developers.stellar.org/meetings/2024/06/27.md)
* Video Tutorial on `alias` and `snapshot` from the [2024-09-12 developers meeting](https://developers.stellar.org/meetings/2024/09/12.md)