📦 Installation & First Request

Installation & First Request: Installing Bruno is like installing any notebook app — download it, open it, start typing.

Installing Bruno is like installing any notebook app — download it, open it, start typing. There's no database server to configure and no account you're forced to create. The only extra piece, if you want automation later, is a small command-line tool (the "CLI") that you can install with one line whenever you're ready for that step. But why should a login screen at install time matter to you at all — isn't an account just a formality you click past once? Consider what the account actually implies: it means your requests live on someone else's server by default. Postman starts you in a workspace that syncs to the cloud; Bruno starts you in a folder on your disk. That single difference decides whether an API key you paste while debugging ends up in a company-approved location or in a vendor's storage — a question your security team will eventually ask you, usually right before an audit. The Java parallel is worth holding onto: this is the difference between an IDE that needs a licence server to open your project and one that reads a plain `pom.xml` from disk. Both edit code; only one still works when the network is down or the vendor changes its pricing. For a QA engineer the practical payoff shows up on day one of a new job: onboarding to an API test suite becomes `git clone` plus opening a folder — no invite, no seat licence, no waiting for someone with admin rights to add you to a workspace.

Where to Download Bruno

Bruno Desktop App — Windows / macOS / Linux

Official source. Pick the installer for your OS: .exe (Windows), .dmg (macOS), .deb/.AppImage/.snap (Linux). The GitHub releases page (github.com/usebruno/bruno/releases) hosts the exact same installers if you prefer downloading from there.

Windows alternative if you use a package manager. Run in PowerShell. Expected output ends with "Successfully installed".

macOS via Homebrew. Expected output: "🍺 bruno was successfully installed!" Bruno.app then appears in Launchpad.

Linux via Snap. Expected output: "bruno from Bruno Software installed". A .AppImage or .deb works the same way if your distro doesn't use Snap.

Verification step for ALL platforms — confirms the app opened and shows a version number, e.g. "Bruno v1.x.x". No login is required to start using it.

Installing the CLI (Optional, for Automation Later)

bru CLI — works the same on Windows, macOS and Linux

Requires Node.js already installed. The -g flag makes the "bru" command available everywhere in your terminal, not just one project folder.

Verification command. Expected output: something like "1.x.x" printed directly — if you instead see "command not found", Node's global npm bin folder is likely missing from your PATH (covered in Common Errors).

Bruno's Interface — Three Panels

Bruno UI — Sidebar, Request Builder, Response (labeled)

Installation steps

  1. Open usebruno.com/downloads — Official source. Pick the installer for your OS: .exe (Windows), .dmg (macOS), .deb/.AppImage/.snap (Linux). The GitHub releases page (github.com/usebruno/bruno/releases) hosts the exact same installers if you prefer downloading from there.
  2. winget install Bruno.Bruno — Windows alternative if you use a package manager. Run in PowerShell. Expected output ends with "Successfully installed".
  3. brew install --cask bruno — macOS via Homebrew. Expected output: "🍺 bruno was successfully installed!" Bruno.app then appears in Launchpad.
  4. sudo snap install bruno — Linux via Snap. Expected output: "bruno <version> from Bruno Software installed". A .AppImage or .deb works the same way if your distro doesn't use Snap.
  5. Launch Bruno and check Help → About — Verification step for ALL platforms — confirms the app opened and shows a version number, e.g. "Bruno v1.x.x". No login is required to start using it.