Installing Red on Windows

Needed Software

The following software dependencies can all be installed quickly and easily through PowerShell, using a trusted package manager for Windows called Chocolatey

We also provide instructions for manually installing all of the dependencies.

Installing using powershell and chocolatey

To install via PowerShell, search “powershell” in the Windows start menu, right-click on it and then click “Run as administrator”

Then run each of the following commands:

Set-ExecutionPolicy Bypass -Scope Process -Force
iex ((New-Object System.Net.WebClient).DownloadString('https://chocolatey.org/install.ps1'))
choco install git --params "/GitOnlyOnPath /WindowsTerminal" -y
choco install visualstudio2019-workload-vctools -y
choco install python3 -y

For Audio support, you should also run the following command before exiting:

choco install adoptopenjdk11jre -y

From here, exit the prompt then continue onto installing Red.

Manually installing dependencies

Attention

There are additional configuration steps required which are not documented for installing dependencies manually. These dependencies are only listed seperately here for reference purposes.

Attention

Please make sure that the box to add Python to PATH is CHECKED, otherwise you may run into issues when trying to run Red.

Attention

Please choose the option to “Git from the command line and also from 3rd-party software” in Git’s setup.

  • Java - needed for Audio

Creating a Virtual Environment

We require installing Red into a virtual environment. Don’t be scared, it’s very straightforward. See the section Installing Red in a Virtual Environment.

Installing Red

Attention

You may need to restart your computer after installing dependencies for the PATH changes to take effect.

  1. Open a command prompt (open Start, search for “command prompt”, then click it)
  2. Run one of the following set of commands, depending on what extras you want installed
  • Normal installation:

    python -m pip install -U pip setuptools wheel
    python -m pip install -U Red-DiscordBot
    
  • With PostgreSQL support:

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

Note

These commands are also used for updating Red

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, section “Creating a Bot Account”.

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.