📦 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
- 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.
- winget install Bruno.Bruno — Windows alternative if you use a package manager. Run in PowerShell. Expected output ends with "Successfully installed".
- brew install --cask bruno — macOS via Homebrew. Expected output: "🍺 bruno was successfully installed!" Bruno.app then appears in Launchpad.
- 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.
- 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.