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

# Upgrade the Astro CLI

The Astro CLI contains no breaking changes between minor versions within the same major version. Therefore, Astronomer recommends always using the latest minor version of the Astro CLI within your major version.

## Upgrade the existing CLI

<Tabs>
  <Tab title="Mac" language="mac">
    Run the following command to upgrade the Astro CLI to the latest version:

    ```sh wrap theme={null}
    brew upgrade astro
    ```
  </Tab>

  <Tab title="Windows with winget" language="windows-winget">
    To upgrade the Astro CLI to the latest version, open Windows PowerShell as an administrator and run the following command:

    ```sh wrap theme={null}
    winget install -e --id Astronomer.Astro
    ```

    Note that if you're upgrading from Astro CLI version 1.5.1 or earlier to a later Astro CLI version, you still need to install the upgrade version manually.
  </Tab>

  <Tab title="Windows (Manual)" language="windows-manual">
    1. Delete the existing `astro.exe` file on your machine.

    2. Go to the [Releases page](https://github.com/astronomer/astro-cli/releases) of the Astro CLI GitHub repository, scroll to a CLI version, and then download the `.exe` file that matches the CPU architecture of your machine.

    For example, to upgrade to v1.0.0 of the Astro CLI on a Windows machine with an AMD 64 architecture, you download `astro_1.0.0-converged_windows_amd64.exe`.

    3. Rename the file to `astro.exe`.

    4. Add the filepath for the directory containing the new `astro.exe` as a PATH environment variable. For example, if `astro.exe` was stored in `C:\Users\username\astro.exe`, you would add `C:\Users\username` as your PATH environment variable. To learn more about configuring the PATH environment variable, see [Java documentation](https://www.java.com/en/download/help/path.html).

    5. Restart your machine.
  </Tab>

  <Tab title="Linux" language="linux">
    To upgrade the Astro CLI to the latest version, run the following command:

    ```sh wrap theme={null}
    curl -sSL install.astronomer.io | sudo bash -s
    ```
  </Tab>
</Tabs>