Install

Redrive ships as a single binary per platform: download it and run it. On startup it opens your browser at http://localhost:5100.

Download

Download the current build from the install band on the homepage. It always points at the latest release.

Windows ships as a bare executable. Linux and macOS ship as a tar.gz archive:

redrive-{version}-win-x64.exe
redrive-{version}-linux-x64.tar.gz
redrive-{version}-osx-arm64.tar.gz

A SHA256SUMS.txt file is published beside them. Verify your download against it before you run the binary.

Windows

Download the .exe file and run it.

Windows SmartScreen blocks the first run with a "Windows protected your PC" warning. Click More info, then Run anyway to continue.

Chrome may also flag the file as "not commonly downloaded." Allow the download to finish anyway.

macOS

Download and run the binary from the terminal:

curl -LO <url> && tar xzf <file> && ./redrive

A binary downloaded this way carries no quarantine flag and runs immediately.

macOS quarantines binaries downloaded through a browser. Clear the quarantine flag before running the binary:

xattr -d com.apple.quarantine redrive

Right-click → Open does not work here. That workaround applies only to app bundles, not bare binaries.

Linux

Download and run the binary from the terminal:

curl -LO <url> && tar xzf <file> && ./redrive

Download the new binary and replace the old one. Redrive migrates the database forward automatically the first time the new version starts, with no separate migration step. Downgrading is not supported. See Deployment for why.

Uninstall

Delete the binary and the data directory. Data directory locations are listed in Configuration.

Reporting a problem

Include the version, from redrive --version or the sidebar in the app, and the log around the time of the error. Logs live in <data-dir>/logs/. Every API error response carries a trace ID that matches a log line, which is the fastest way to find the right spot.

Continue to Getting started to connect your first broker.