Installing Red on macOS

We support hosting Red on computers running an x86-64 or aarch64 version of this system.
You can read more about systems and processor architectures we support in our End-user Guarantees.

Installing the pre-requirements

To install pre-requirements, we first have to install Brew. In Finder or Spotlight, search for and open Terminal. In the terminal, paste the following, then press Enter:

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew_location="$([ -n "$HOMEBREW_PREFIX" ] && echo "$HOMEBREW_PREFIX" || ([ "$(/usr/bin/uname -m)" = "arm64" ] && echo /opt/homebrew || echo /usr/local))/bin/brew"
printf '\neval "$(%s shellenv)"\n' "$brew_location" >> "$([ -n "$ZSH_VERSION" ] && echo ~/.zprofile || ([ -f ~/.bash_profile ] && echo ~/.bash_profile || echo ~/.profile))"
eval "$("$brew_location" shellenv)"

After the installation, install the required packages by pasting the commands and pressing enter, one-by-one:

brew install python@3.11
brew install git
brew install temurin@17

By default, Python installed through Homebrew is not added to the load path. To fix this, you should run these commands:

echo 'export PATH="$(brew --prefix)/opt/python@3.11/bin:$PATH"' >> "$([ -n "$ZSH_VERSION" ] && echo ~/.zprofile || ([ -f ~/.bash_profile ] && echo ~/.bash_profile || echo ~/.profile))"
export PATH="$(brew --prefix)/opt/python@3.11/bin:$PATH"

Creating a Virtual Environment

Tip

If you want to learn more about virtual environments, see page: About Virtual Environments

We require installing Red into a virtual environment. Don’t be scared, it’s very straightforward.

Using venv

This is the quickest way to get your virtual environment up and running, as venv is shipped with python.

First, choose a directory where you would like to create your virtual environment. It’s a good idea to keep it in a location which is easy to type out the path to. From now, we’ll call it redenv and it will be located in your home directory.

Create your virtual environment with the following command:

python3.11 -m venv ~/redenv

And activate it with the following command:

source ~/redenv/bin/activate

Important

You must activate the virtual environment with the above command every time you open a new shell to run, install or update Red.

Installing Red

Choose one of the following commands to install Red.

To install without additional config backend support:

python -m pip install -U pip wheel
python -m pip install -U Red-DiscordBot

Or, to install with PostgreSQL support:

python -m pip install -U pip wheel
python -m pip install -U "Red-DiscordBot[postgres]"

Setting Up and Running Red

After installation, set up your instance with the following command:

redbot-setup

This will set the location where data will be stored, as well as your storage backend and the name of the instance (which will be used for running the bot).

Once done setting up the instance, run the following command to run Red:

redbot <your instance name>

It will walk through the initial setup, asking for your token and a prefix. You can find out how to obtain a token with this guide.

Tip

If it’s the first time you’re using Red, you should check our Getting started guide that will walk you through all essential information on how to interact with Red.