Skip to main content

​
Installation Methods

Bruno is available as a binary download and through various package managers for Mac, Windows, and Linux. Choose the installation method that works best for your platform.

​
Binary Download

Download the latest version from usebruno.com/downloads.

​
Homebrew

The recommended way to install Bruno on Mac:
brew install bruno
Homebrew will automatically keep Bruno updated when you run brew upgrade.

​
Installing Bruno CLI

The Bruno CLI allows you to run your API collections from the command line, making it easy to integrate with CI/CD workflows.

​
Using npm

npm install -g @usebruno/cli

​
Using yarn

yarn global add @usebruno/cli

​
Using pnpm

pnpm add -g @usebruno/cli

​
Verify Installation

Check that the CLI is installed correctly: 
bru --version
The CLI requires Node.js v22.x or the latest LTS version to be installed on your system.

​
System Requirements

  • macOS 10.13 or later
  • 64-bit processor
  • At least 200MB of free disk space
  • Windows 10 or later
  • 64-bit processor
  • At least 200MB of free disk space
  • 64-bit distribution
  • At least 200MB of free disk space
  • For Snap: snapd installed
  • For Flatpak: flatpak runtime installed

​
Verifying Your Installation

After installation, launch Bruno from your applications menu or by running: 
bruno
You should see the Bruno application window open.
Congratulations! Bruno is now installed on your system.

​
Updating Bruno

The update process depends on how you installed Bruno:
Package managers will handle updates automatically or through their standard update commands:
# Homebrew (Mac)
brew upgrade bruno

# Chocolatey (Windows)
choco upgrade bruno

# Scoop (Windows)
scoop update bruno

# Snap (Linux)
snap refresh bruno

# Flatpak (Linux)
flatpak update com.usebruno.Bruno

# Apt (Debian/Ubuntu)
sudo apt update && sudo apt upgrade bruno

​
Uninstalling Bruno

# Homebrew
brew uninstall bruno

# Manual installation
# Drag Bruno.app to Trash
Uninstalling Bruno will not delete your API collections, as they are stored in your chosen directory on your filesystem.

​
Troubleshooting

If you see a security warning about Bruno being from an unidentified developer:
  1. Open System Preferences > Security & Privacy
  2. Click “Open Anyway” next to the Bruno warning
  3. Confirm you want to open the app
Make sure you have the required dependencies installed:
sudo apt-get install libgtk-3-0 libnotify4 libnss3 libxss1 libxtst6 xdg-utils libatspi2.0-0 libappindicator3-1 libsecret-1-0
If bru command is not found after installation:
  1. Make sure npm global bin directory is in your PATH
  2. Find the path with: npm config get prefix
  3. Add <prefix>/bin to your PATH environment variable

​
Next Steps

Quick Start Guide

Make your first API request with Bruno.

CLI Documentation

Learn how to use the Bruno CLI.

Build docs developers (and LLMs) love

Get started for freeTalk to us