Skip to main content
Version: Latest


In this setup we will create an autobrr user and a macOS service that operates in the background. This way we won't need to have a command prompt window open 24/7.


Homebrew is a free and open-source software package management system that simplifies the installation of software on macOS and Linux. Known as "the missing package manager for macOS," it extends or fills gaps in the standard software management offerings on these operating systems. Homebrew allows users to easily install, update, and manage software packages and their dependencies through simple commands in the terminal.

Install Homebrew

/bin/bash -c "$(curl -fsSL"

Alternatively use their .pkg installer. Download it from Homebrew's latest GitHub release.

Install autobrr

brew install autobrr


To start autobrr now and restart at login:

brew services start autobrr

Or, if you don't want/need a background service you can just run:

/opt/homebrew/opt/autobrr/bin/autobrr --config /opt/homebrew/var/autobrr/

Listen address


By default autobrr listens on which is the recommended way when running a reverse proxy, but if you want to expose it to the internet/network then you must change the host in the config.toml from to

Restart autobrr after.

It's recommended to run it behind a reverse proxy like Caddy (very simple) or nginx (moderately simple) in order to get TLS, more robust authentication mechanisms and other similar benefits.

You can install nginx on macOS with Homebrew:

brew install nginx

Please see the Reverse proxy section for reverse proxy configuration examples.

Finishing up

Now that autobrr is up and running, you should be able to visit the your web UI at http://YOUR_IP:7474 or and proceed with your registration/login.

Version Updates

To upgrade Autobrr to the latest version first stop the service (if you have configured it):

brew services stop autobrr


brew update
brew upgrade autobrr
brew services start autobrr