Install - Qonto

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:

curl -fsSL https://install.qonto.com/cli | 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:

irm https://install.qonto.com/cli.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

qonto version

Then sign in, see Authentication:

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.

curl -fsSL https://install.qonto.com/cli | QONTO_VERSION=0.2.1 sh
curl -fsSL https://install.qonto.com/cli | QONTO_INSTALL_DIR="$HOME/bin" sh

$env:QONTO_VERSION = '0.2.1'; irm https://install.qonto.com/cli.ps1 | iex
$env:QONTO_INSTALL_DIR = 'C:\tools\qonto'; irm https://install.qonto.com/cli.ps1 | iex

Packages and manual downloads

Every release is published under https://install.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:

curl -fsSLO https://install.qonto.com/cli/releases/v0.2.1/qonto_0.2.1_amd64.deb
curl -fsSLO https://install.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.

Verify the integrity of a download

A checksum is a short fingerprint of a file: change a single byte and the fingerprint changes completely. Comparing a download’s checksum with the published one tells you the file is intact and exactly the one Qonto released, not corrupted or altered on the way. Every release publishes the SHA-256 checksum of each of its files in a public checksums.txt, next to the files. The installers check it for you and refuse to install on a mismatch. To check a file you downloaded yourself:

curl -fsSLO https://install.qonto.com/cli/releases/v0.2.1/qonto_0.2.1_Darwin_universal.tar.gz
curl -fsSLO https://install.qonto.com/cli/releases/v0.2.1/checksums.txt
shasum -a 256 --ignore-missing -c checksums.txt

curl -fsSLO https://install.qonto.com/cli/releases/v0.2.1/qonto_0.2.1_Linux_x86_64.tar.gz
curl -fsSLO https://install.qonto.com/cli/releases/v0.2.1/checksums.txt
sha256sum --ignore-missing -c checksums.txt

$version = '0.2.1'
$name = "qonto_${version}_Windows_x86_64.zip"
$url = "https://install.qonto.com/cli/releases/v$version"
Invoke-WebRequest "$url/$name" -OutFile $name
Invoke-WebRequest "$url/checksums.txt" -OutFile checksums.txt
$want = (Select-String -Path checksums.txt -Pattern " $name$").Line.Split(' ')[0]
$got = (Get-FileHash $name -Algorithm SHA256).Hash
if ($got -eq $want) { "OK" } else { "MISMATCH: expected $want, got $got" }

A match prints OK (on macOS and Linux, qonto_0.2.1_Darwin_universal.tar.gz: OK). FAILED or MISMATCH means the file is not the one published: delete it and download it again. On macOS, the code signature check also confirms that Qonto built the program. To read the installer before it runs, download it first, then run the file you read:

curl -fsSL https://install.qonto.com/cli -o install.sh
less install.sh
sh install.sh

Invoke-WebRequest https://install.qonto.com/cli.ps1 -OutFile install.ps1
notepad install.ps1
Get-Content install.ps1 -Raw | Invoke-Expression

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

Sign out

qonto auth logout

This removes the session from your credential store and revokes its tokens at Qonto.

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).

Remove the configuration (optional)

Delete ~/.config/qonto (%USERPROFILE%\.config\qonto on Windows), which holds the configuration file and, if you used --store-cleartext, the session file.

​macOS and Linux

​Windows

​Check the installation

​Install options

​Packages and manual downloads

​Verify the integrity of a download

​Update

​Uninstall