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

# Install

> Install the Qonto CLI on macOS, Linux, or Windows

The Qonto CLI is one self-contained program with no runtime to install. The installers below detect your operating system and processor, download the matching release together with its `checksums.txt`, check the SHA-256 of the download, and refuse to install if it does not match.

## macOS and Linux

In a terminal:

```bash theme={null}
curl -fsSL https://mcp.qonto.com/cli/install | sh
```

The program is installed as `/usr/local/bin/qonto`, using `sudo` if that directory is not writable. Without `sudo`, it goes to `~/.local/bin/qonto`, and the installer tells you if that directory is not on your `PATH`.

On macOS, a single universal program runs on both Apple silicon and Intel Macs. It is signed with Qonto's Apple Developer ID and notarized by Apple, so Gatekeeper lets it run even if you downloaded the archive with a browser.

## Windows

In PowerShell:

```powershell theme={null}
irm https://mcp.qonto.com/cli/install.ps1 | iex
```

The program is installed as `%LOCALAPPDATA%\Programs\qonto\qonto.exe`, and that directory is added to your user `PATH`. Open a new terminal afterwards so the change is picked up.

## Check the installation

```bash theme={null}
qonto version
```

Then sign in, see [Authentication](/cli/authentication):

```bash theme={null}
qonto auth login
```

## Install options

Two environment variables change what the installers do:

| Variable            | Effect                                                                |
| ------------------- | --------------------------------------------------------------------- |
| `QONTO_VERSION`     | Install this version (for example `0.2.1`) instead of the latest one. |
| `QONTO_INSTALL_DIR` | Install into this directory instead of the default one.               |

<CodeGroup>
  ```bash macOS and Linux theme={null}
  curl -fsSL https://mcp.qonto.com/cli/install | QONTO_VERSION=0.2.1 sh
  curl -fsSL https://mcp.qonto.com/cli/install | QONTO_INSTALL_DIR="$HOME/bin" sh
  ```

  ```powershell Windows theme={null}
  $env:QONTO_VERSION = '0.2.1'; irm https://mcp.qonto.com/cli/install.ps1 | iex
  $env:QONTO_INSTALL_DIR = 'C:\tools\qonto'; irm https://mcp.qonto.com/cli/install.ps1 | iex
  ```
</CodeGroup>

## Packages and manual downloads

Every release is published under `https://mcp.qonto.com/cli/releases/v<version>/`:

| File                                                                        | For                            |
| --------------------------------------------------------------------------- | ------------------------------ |
| `qonto_<version>_Darwin_universal.tar.gz`                                   | macOS, Apple silicon and Intel |
| `qonto_<version>_Linux_x86_64.tar.gz`, `qonto_<version>_Linux_arm64.tar.gz` | Linux                          |
| `qonto_<version>_amd64.deb`, `qonto_<version>_arm64.deb`                    | Debian, Ubuntu                 |
| `qonto_<version>_amd64.rpm`, `qonto_<version>_arm64.rpm`                    | Fedora, RHEL                   |
| `qonto_<version>_amd64.apk`, `qonto_<version>_arm64.apk`                    | Alpine                         |
| `qonto_<version>_Windows_x86_64.zip`, `qonto_<version>_Windows_arm64.zip`   | Windows                        |
| `checksums.txt`                                                             | SHA-256 of every file above    |

For example, on Debian or Ubuntu:

```bash theme={null}
curl -fsSLO https://mcp.qonto.com/cli/releases/v0.2.1/qonto_0.2.1_amd64.deb
curl -fsSLO https://mcp.qonto.com/cli/releases/v0.2.1/checksums.txt
sha256sum --ignore-missing -c checksums.txt
sudo dpkg -i qonto_0.2.1_amd64.deb
```

The packages install the program as `/usr/bin/qonto`.

## Update

Run the same install command again: it replaces the program with the latest release. The CLI checks for new versions once a day and prints a one-line notice when one is available. If your version is ever about to stop being supported, it says so and gives the date.

## Uninstall

<Steps>
  <Step title="Sign out">
    ```bash theme={null}
    qonto auth logout
    ```

    This removes the session from your credential store and revokes its tokens at Qonto.
  </Step>

  <Step title="Remove the program">
    Delete `qonto` from where it was installed: `/usr/local/bin/qonto` or `~/.local/bin/qonto` on macOS and Linux, `%LOCALAPPDATA%\Programs\qonto` on Windows. If you installed a package, remove it with your package manager (`sudo apt remove qonto`, `sudo dnf remove qonto`, `sudo apk del qonto`).
  </Step>

  <Step title="Remove the configuration (optional)">
    Delete `~/.config/qonto` (`%USERPROFILE%\.config\qonto` on Windows), which holds the configuration file and, if you used [`--store-cleartext`](/cli/authentication#machines-without-a-credential-store), the session file.
  </Step>
</Steps>