selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

GitHub
docker-red-discordbot logo

Self-host docker-red-discordbot

Docker image for Red-DiscordBot with auto-updates

ReleaseOpen SourceGPL-3.0
Updated11 months ago
LanguagePython
Setup difficultyModerate
Stars
356
Docker
phasecorex/red-discordbot
Install with Docker

What is docker-red-discordbot?

This project packages the Red-DiscordBot Discord bot into a multi-architecture Docker container. It runs as a non-root user with configurable UID and GID, automatically updates to the newest PyPI release each time the container restarts, and stores data in a mounted volume. Several image tags are provided: a minimal core variant, an audio-enabled variant with Java and Lavalink, and extended variants that include system packages for popular third-party cogs. PyLav integration tags are also available. Configuration uses environment variables for the bot token, command prefix, timezone, storage backend (JSON or PostgreSQL), version pinning, and extra startup flags. The bot's RPC interface for external dashboards only functions when the container uses host networking. There is no web UI or mobile app; administration is done through Discord chat commands.

Should you self-host docker-red-discordbot?

docker-red-discordbot scores 51/100 on selfhost.directory (how scoring works) and ranks #46 of 110 in Chat. It has 356 GitHub stars.

There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is Zulip (82/100, 26 127 stars). It scores higher overall, so compare the two before you pick. See docker-red-discordbot vs Zulip side by side.

Features

  • Auto-update on restart
  • Custom package supportFor advanced users only
  • Extensible base image
  • Multiple command prefixes
  • Multiple Storage Backends
  • Non-root execution
  • One-time configuration
  • PyLav integrationRequires separate PostgreSQL for PyLav data
  • RPC for dashboardsOnly works in host networking mode
  • Third-party cog supportAvailable in extra and extra-audio tags
  • Unraid Community Apps
  • Update Notifications
  • Version pinning

docker-red-discordbot README

How to install docker-red-discordbot

Install docker-red-discordbot with Docker

Environment variables
TOKEN, PREFIX, PREFIX2-5, OWNER, TZ, PUID, PGID, NICENESS, STORAGE_TYPE, REDBOT_VERSION, EXTRA_ARGS, CUSTOM_REDBOT_PACKAGE

docker run -v /local/folder/for/persistence:/data -e TOKEN=bot_token -e PREFIX=. phasecorex/red-discordbot

Replace /local/folder/for/persistence with your data directory and bot_token with your Discord bot token

How to configure docker-red-discordbot

  • CUSTOM_REDBOT_PACKAGECustom pip package specifier for Red-DiscordBot (e.g., git+https://github.com/Cog-Creators/Red-DiscordBot.git)

    Custom pip package specifier for Red-DiscordBot (e.g., git+https://github.com/Cog-Creators/Red-DiscordBot.git)

  • EXTRA_ARGSExtra arguments passed to Red-DiscordBot startup command

    Extra arguments passed to Red-DiscordBot startup command

    values: --no-cogs, --dry-run, --debug, etc.

  • NICENESS0Process niceness value from -20 to 19 (default: 0)

    Process niceness value from -20 to 19 (default: 0)

    values: -20 to 19

  • OWNERDiscord user ID to set as the bot owner

    Discord user ID to set as the bot owner

  • PGID1000Group ID the bot runs as (default: same as PUID)

    Group ID the bot runs as (default: same as PUID)

  • PREFIX.The command prefix for the bot (default: .)

    The command prefix for the bot (default: .)

  • PREFIX2Additional command prefix

    Additional command prefix

  • PREFIX3Additional command prefix

    Additional command prefix

  • PREFIX4Additional command prefix

    Additional command prefix

  • PREFIX5Additional command prefix

    Additional command prefix

  • PUID1000User ID the bot runs as (default: 1000)

    User ID the bot runs as (default: 1000)

  • REDBOT_VERSIONPin Red-DiscordBot to a specific version using pip version specifiers

    Pin Red-DiscordBot to a specific version using pip version specifiers

    values: ==3.5.0, ~=3.5.0, etc.

  • STORAGE_TYPEJSONDatastore type (e.g., postgres for PostgreSQL, default: JSON)

    Datastore type (e.g., postgres for PostgreSQL, default: JSON)

    values: postgres, etc.

  • TOKENThe bot token for Red-DiscordBot to authenticate with Discord

    The bot token for Red-DiscordBot to authenticate with Discord

  • TZUTCTimezone for the container (default: UTC)

    Timezone for the container (default: UTC)

More in Chat

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…