Install Bruno on macOS (DMG, PKG installer, Homebrew), Windows (EXE, MSI, winget, Chocolatey, Scoop) and Linux (AppImage, deb, rpm, APT, Flatpak, Snap).
Bruno is an open-source, fast and lightweight API client for exploring and testing APIs. It’s designed to be a modern alternative to traditional API clients with a focus on speed, simplicity, and collaboration.
Installation Options
Bruno can be installed via direct download or through package managers on supported platforms.
Enterprise MSI InstallationWhen installing Bruno using an MSI installer, IT administrators can control auto-update behavior by passing the AUTOUPDATE_ENABLED flag during installation:
Set to false to disable auto-updates enterprise-wide
If auto-updates are disabled by the enterprise, users cannot enable them manually
If no enterprise setting exists, Bruno respects individual user preferences
# Create keyrings directorysudo mkdir -p /etc/apt/keyrings# Update and install GPG and curlsudo apt update && sudo apt install gpg curl# List existing keys (optional)sudo gpg --list-keys# Add the Bruno repository keycurl -fsSL "https://keyserver.ubuntu.com/pks/lookup?op=get&search=0x9FA6017ECABE0266" | gpg --dearmor | sudo tee /etc/apt/keyrings/bruno.gpg > /dev/null# Set permissions for the GPG key filesudo chmod 644 /etc/apt/keyrings/bruno.gpg# Add the Bruno repositoryecho "deb [arch=amd64 signed-by=/etc/apt/keyrings/bruno.gpg] http://debian.usebruno.com/ bruno stable" | sudo tee /etc/apt/sources.list.d/bruno.list# Update and install Brunosudo apt update && sudo apt install bruno
Flatpak
flatpak install flathub com.usebruno.Bruno
Snap
sudo snap install bruno
Nightly Builds
Nightly builds are pre-release and may contain bugs. Use them to preview
upcoming features and provide feedback - not for production.
Nightly builds are published automatically for early testing of upcoming features. To get started, visit the bruno-nightly-builds ↗ repository on GitHub and download the asset that matches your OS.
Install it the same way as a regular Bruno release.
The CLI nightly build is published as an npm tarball (.tgz). Installing it in an isolated folder keeps it separate from any globally installed version.
1
Prepare a test folder
Download the .tgz file from the nightly builds repository ↗ and keep the original filename unchanged. Then create a clean folder and move the file into it:
npx bru --version# Expected output: the nightly version number, e.g. 3.5.0
4
Run your collection using the local CLI
The nightly binary is installed inside cli-portable-nightly/node_modules/.bin/bru. When you want to run a collection that lives in a different folder, you must use the full absolute path to that binary.Using ./node_modules/.bin/bru only works from inside the cli-portable-nightly folder itself.
# Step into your collection foldercd /path/to/your-collection# macOS / Linux — use the absolute path to the nightly binary/path/to/cli-portable-nightly/node_modules/.bin/bru run --env <name># WindowsC:\path\to\cli-portable-nightly\node_modules\.bin\bru run --env <name>
If you are not sure of the path, run pwd while inside cli-portable-nightly to get it:
cd /path/to/cli-portable-nightlypwd# e.g. /Users/yourname/Downloads/cli-portable-nightly
Then use that output as the prefix:
cd /path/to/your-collection/Users/yourname/Downloads/cli-portable-nightly/node_modules/.bin/bru run --env <name>
To avoid typing the full path every time, export it as a shell variable for your session:
export NIGHTLY_BRU=/Users/yourname/Downloads/cli-portable-nightly/node_modules/.bin/brucd /path/to/your-collection$NIGHTLY_BRU run --env <name>
Release Information
Bruno follows semantic versioning. You can check the GitHub Releases ↗ page for: