Web Dashboard

Dashboard cog setup with a separate venv so the RedBot venv stays clean.

1. Create dashboard venv

python3.11 -m venv ~/redbotdashboard
source ~/redbotdashboard/bin/activate
pip install -U pip wheel setuptools
pip install git+https://github.com/AAA3A-AAA3A/Red-Web-Dashboard.git
pip install flask-wtf==1.2.1

2. Enable RPC in RedBot systemd

The instance name comes from redbot-setup. If your service is red@YOUR_INSTANCE_NAME, keep using that name.

ExecStart=/home/ubuntu/redenv/bin/python -O -m redbot %i --owner YOUR_DISCORD_USER_ID --team-members-are-owners --no-prompt --rpc

sudo systemctl daemon-reload
sudo systemctl restart red@YOUR_INSTANCE_NAME

3. Configure Dashboard cog

Run in DM with the bot after adding the redirect URI in Discord Developer Portal.

oa setdashboard redirecturi https://YOUR_DASHBOARD_DOMAIN/callback
oa setdashboard secret YOUR_CLIENT_SECRET

4. Caddy reverse proxy

YOUR_DASHBOARD_DOMAIN {
    reverse_proxy localhost:42356
}

sudo systemctl restart caddy

5. Dashboard systemd service

[Unit]
Description=Red-Web-Dashboard
After=network-online.target red@YOUR_INSTANCE_NAME.service
Wants=network-online.target

[Service]
User=ubuntu
Group=ubuntu
ExecStart=/home/ubuntu/redbotdashboard/bin/reddash --host localhost --port 42356
Restart=on-abnormal
RestartSec=15

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable reddash
sudo systemctl start reddash
sudo systemctl status reddash