Installation

Choose Your Installation Method

Select the installation method that best suits your system and preferences:

Pre-built Binaries

Download and install pre-compiled CLI binaries

GUI Application

Desktop application for visual torrent management

Package Managers

Install using your preferred package manager

Docker

Install using Docker

Install mkbrr

Pre-built Binaries
Package Managers
Docker
Go Install
GUI Application

Download the appropriate binary for your system from the GitHub Releases page or use the commands below.

Linux
macOS
Windows

Generic (tar.gz)
Debian/Ubuntu (.deb)
Fedora/CentOS (.rpm)
Alpine (.apk)

Make sure the extraction directory (e.g., /usr/local/bin) is included in your system’s PATH environment variable so you can run mkbrr from any location.

x86_64
arm64
arm

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_x86_64 | cut -d\" -f4)
sudo tar -C /usr/local/bin -xzf mkbrr_*_linux_x86_64.tar.gz mkbrr

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_arm64.tar.gz | cut -d\" -f4)
sudo tar -C /usr/local/bin -xzf mkbrr_*_linux_arm64.tar.gz mkbrr

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_arm.tar.gz | grep -v arm64 | cut -d\" -f4)
sudo tar -C /usr/local/bin -xzf mkbrr_*_linux_arm.tar.gz mkbrr

amd64
arm64
armv6

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_amd64.deb | cut -d\" -f4)
sudo dpkg -i mkbrr_*_linux_amd64.deb

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_arm64.deb | cut -d\" -f4)
sudo dpkg -i mkbrr_*_linux_arm64.deb

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_armv6.deb | cut -d\" -f4)
sudo dpkg -i mkbrr_*_linux_armv6.deb

amd64
arm64
armv6

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_amd64.rpm | cut -d\" -f4)
sudo rpm -i mkbrr_*_linux_amd64.rpm

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_arm64.rpm | cut -d\" -f4)
sudo rpm -i mkbrr_*_linux_arm64.rpm

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_armv6.rpm | cut -d\" -f4)
sudo rpm -i mkbrr_*_linux_armv6.rpm

amd64
arm64
armv6

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_amd64.apk | cut -d\" -f4)
sudo apk add --allow-untrusted mkbrr_*_linux_amd64.apk

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_arm64.apk | cut -d\" -f4)
sudo apk add --allow-untrusted mkbrr_*_linux_arm64.apk

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep linux_armv6.apk | cut -d\" -f4)
sudo apk add --allow-untrusted mkbrr_*_linux_armv6.apk

Ensure the extraction directory (e.g., /usr/local/bin) is included in your system’s PATH environment variable so you can run mkbrr from any location.

Apple Silicon (arm64)
Intel (x86_64)

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep darwin_arm64.tar.gz | cut -d\" -f4)
sudo tar -C /usr/local/bin -xzf mkbrr_*_darwin_arm64.tar.gz mkbrr

wget $(curl -s https://api.github.com/repos/autobrr/mkbrr/releases/latest | grep download | grep darwin_x86_64.tar.gz | cut -d\" -f4)
sudo tar -C /usr/local/bin -xzf mkbrr_*_darwin_x86_64.tar.gz mkbrr

If you encounter issues with macOS Gatekeeper preventing mkbrr from running, execute the following command to remove the quarantine attribute: xattr -d com.apple.quarantine /usr/local/bin/mkbrr. You might also need to grant execution permissions: chmod +x /usr/local/bin/mkbrr.

Download the mkbrr_*_windows_x86_64.zip file from the GitHub Releases page.Alternatively, using PowerShell (requires curl):

# Download (Uses Invoke-RestMethod for reliable JSON parsing)
$releaseInfo = Invoke-RestMethod -Uri "https://api.github.com/repos/autobrr/mkbrr/releases/latest"
$url = $releaseInfo.assets | Where-Object { $_.name -like '*windows_x86_64.zip' } | Select-Object -ExpandProperty browser_download_url
curl -L -o mkbrr_latest_windows_x86_64.zip $url

# Extract
Expand-Archive -Path mkbrr_latest_windows_x86_64.zip -DestinationPath .\\mkbrr_extracted -Force

To run mkbrr from any terminal after extracting mkbrr.exe, you need to make it accessible via your system’s PATH:

Move mkbrr.exe to a directory already in your PATH (e.g., create C:\Program Files\mkbrr and move it there).
Or, add the directory where you extracted mkbrr.exe to your system or user PATH environment variable (accessible via System Properties -> Environment Variables).

Homebrew (macOS/Linux)
Arch Linux (AUR)
Alpine Linux

If you use Homebrew, you can install mkbrr with these commands:

brew tap autobrr/mkbrr
brew install mkbrr

For Arch Linux users, mkbrr is available in the Arch User Repository (AUR):

yay -S mkbrr

You can also install it manually:

git clone https://aur.archlinux.org/mkbrr.git
cd mkbrr
makepkg -si

The version in the AUR might be outdated. After installing via AUR, it is highly recommended to immediately run mkbrr update to get the latest official release directly from GitHub.

mkbrr is available in the official Alpine edge/testing repository:

sudo apk update
sudo apk add mkbrr

The version in the Alpine testing repository might be outdated. After installing via apk add mkbrr, it is highly recommended to immediately run mkbrr update to get the latest official release directly from GitHub.

Pull the image:

docker pull ghcr.io/autobrr/mkbrr

Tag it for convenience:

docker tag ghcr.io/autobrr/mkbrr mkbrr

Run and mount your input/output directories:

docker run -v ~/Downloads:/downloads mkbrr mkbrr create /downloads/your-file --output-dir /downloads

Replace ~/Downloads with the path on your host containing the files you want to process.

For convenience, add an alias to your shell configuration (e.g., .zshrc or .bashrc): alias mkbrr='docker run -v ~/Downloads:/downloads mkbrr mkbrr'

If you want mkbrr to automatically discover your presets.yaml or other config files, set the working directory (-w) to the config directory inside the container. mkbrr searches for config files in the current working directory and standard config paths (like /root/.config/mkbrr). For example, if your config is in /mnt/user/appdata/mkbrr on your host:

alias mkbrr='docker run --rm \
  -v /mnt/user/data/complete/Music:/music \
  -v /mnt/user/data/torrentfiles/created:/torrentfiles \
  -v /mnt/user/appdata/mkbrr:/root/.config/mkbrr \
  -w /root/.config/mkbrr \
  ghcr.io/autobrr/mkbrr mkbrr'

Rootless Docker

When running Docker in rootless mode, you may encounter permission issues when writing torrent files. To fix this, use the --user flag to run the container as your current user:

docker run --user $(id -u):$(id -g) -v ~/Downloads:/downloads ghcr.io/autobrr/mkbrr mkbrr create /downloads/your-file --output-dir /downloads

For your alias:

alias mkbrr='docker run --rm --user $(id -u):$(id -g) -v ~/Downloads:/downloads ghcr.io/autobrr/mkbrr mkbrr'

If you have Go installed (version 1.23 or later recommended), you can install mkbrr using:

go install github.com/autobrr/mkbrr@latest

Ensure that your Go binary path ($(go env GOPATH)/bin) is included in your system’s PATH environment variable so the mkbrr command can be found. You might need to add this line to your shell profile (e.g., .bashrc, .zshrc, .profile):

echo 'export PATH=$PATH:$(go env GOPATH)/bin' >> ~/.zshrc && source ~/.zshrc

mkbrr includes a graphical user interface for those who prefer a visual experience. Download the GUI binary for your platform from the GitHub Releases page.

macOS
Windows
Linux

Download mkbrr-gui_*_darwin_*.zip and extract the .app bundle.

The app is not notarized, so macOS will block it by default. Use one of these methods:

Option 1: Remove quarantine attribute (recommended)

xattr -cr /path/to/mkbrr-gui.app

Option 2: Right-click to open

Right-click (or Control-click) on the app
Select “Open” from the context menu
Click “Open” in the dialog

Option 3: System Settings

Try to open the app (it will be blocked)
Open System Settings > Privacy & Security
Click “Open Anyway” next to the mkbrr-gui message

Download mkbrr-gui_*_windows_amd64.zip and extract mkbrr-gui.exe.Run the executable directly - no installation required.

Download mkbrr-gui_*_linux_amd64.zip and extract the binary.

chmod +x mkbrr-gui
./mkbrr-gui

For detailed GUI features and usage, see the GUI Application guide.

Verify Installation

After installation, verify that mkbrr is working correctly:

mkbrr version

If you see the version number, mkbrr is installed correctly!

Troubleshooting

If you encounter any issues during installation:

Package Manager Version Outdated

If you installed mkbrr through a package manager (Homebrew, AUR, Alpine) and notice it’s not the latest version:

mkbrr update

This will update mkbrr to the latest version directly from GitHub.

macOS Gatekeeper Issues

If macOS prevents mkbrr from running due to security settings:

xattr -d com.apple.quarantine /usr/local/bin/mkbrr
chmod +x /usr/local/bin/mkbrr

Command Not Found

If you get a “command not found” error after installation, ensure the installation directory is in your PATH:

# For Go installations
echo 'export PATH=$PATH:$(go env GOPATH)/bin' >> ~/.zshrc && source ~/.zshrc

# For binary installations
echo 'export PATH=$PATH:/usr/local/bin' >> ~/.zshrc && source ~/.zshrc

Need help? Join our Discord community or open an issue on GitHub.

Get Started

Usage

Features

Performance

Development

Installation

Pre-built Binaries

GUI Application

Package Managers

Docker