|
5 | 5 |
|
6 | 6 | [Red Discord Bot](https://discord.red), now containerised. |
7 | 7 |
|
8 | | -> [!NOTE] |
9 | | -> This is an unsupported deployment method for Red. Do not expect support from the developers of Red Discord Bot if you run into any issues. |
10 | | -
|
11 | | -* [Tags](#tags) |
12 | | -* [Environment Variables](#environment-variables) |
13 | | - * [Additional Options](#additional-options) |
14 | | -* [Setup](#setup) |
| 8 | +* [Getting Started](#getting-started) |
15 | 9 | * [Prerequisites](#prerequisites) |
16 | 10 | * [Running the bot with `docker compose`](#running-the-bot-with-docker-compose) |
17 | 11 | * [Running the bot with `docker run`](#running-the-bot-with-docker-run) |
18 | | -* [Migrating from `rhomelab:labbot`](#migrating-from-rhomelablabbot) |
19 | | - |
20 | | -## Tags |
21 | | - |
22 | | -| **Tags** | **Red version** | |
23 | | -|:------------:|:--------------------------------------------------------------------------------:| |
24 | | -| `latest` | [Latest release](https://github.com/Cog-Creators/Red-DiscordBot/releases/latest) | |
25 | | -| x.x.x | See tag | |
26 | | - |
27 | | -## Environment Variables |
28 | | - |
29 | | -| Name | Description | Type | Default | |
30 | | -|---------------------------|-----------------------------------------------------------------------------------------|---------|----------| |
31 | | -| `INSTANCE_NAME` | The name of your Red Bot instance.<br>Example: `MyBot` | string | `RedBot` | |
32 | | -| `PREFIX` | Your bot's command prefix.<br>Example: `!` | string | | |
33 | | -| `TOKEN` | Your bot token from Discord Developers. | string | | |
34 | | -| `RPC_ENABLED` | Whether [RPC](https://docs.discord.red/en/stable/framework_rpc.html) is enabled or not. | boolean | `false` | |
35 | | -| `RPC_PORT` | The port used by Red's RPC server, if enabled. | string | `6133` | |
36 | | -| `TEAM_MEMBERS_ARE_OWNERS` | Treat Discord Developers application team members as owners. | boolean | `false` | |
37 | | -| `PIP_REQUIREMENTS` | Optional space-separated list of pip packages to install. | string | | |
38 | | - |
39 | | -### Additional Options |
40 | | - |
41 | | -If you wish to pass additional options to the `redbot` command, these can be added to the `command` option in [`docker-compose.yml`](docker-compose-example.yml) or appended to the `docker run` command. |
42 | | - |
43 | | -> [!WARNING] |
44 | | -> Do not add arguments which conflict with existing environment variables, such as `--prefix`, `--rpc`, etc. |
| 12 | +* [Tags](#tags) |
| 13 | +* [Environment Variables](#environment-variables) |
| 14 | + * [Additional Options](#additional-options) |
45 | 15 |
|
46 | | -> [!TIP] |
47 | | -> You can see a full list of `redbot` options [here](https://github.com/rHomelab/Red-DiscordBot-Docker/blob/main/.github/redbot-arguments.txt). |
| 16 | +> [!NOTE] |
| 17 | +> This is an unsupported deployment method for Red. Do not expect support from the developers of Red Discord Bot if you run into any issues. |
48 | 18 |
|
49 | | -## Setup |
| 19 | +## Getting Started |
50 | 20 |
|
51 | 21 | See the [`docker-compose-example.yml`](docker-compose-example.yml) for a basic example of a working bot with Docker Compose. |
52 | 22 |
|
@@ -90,3 +60,32 @@ docker run -d \ |
90 | 60 | ``` |
91 | 61 |
|
92 | 62 | To retrieve the invitation URL, run `docker logs RedBot`. If you only started the container a few moments ago, you may need to wait a few seconds for the bot to be created, started, and connected. |
| 63 | + |
| 64 | +## Tags |
| 65 | + |
| 66 | +| Tag | Description | |
| 67 | +| -------- | -------------------------------------------------------------------------------------------------- | |
| 68 | +| `latest` | [Latest release](https://github.com/Cog-Creators/Red-DiscordBot/releases/latest) of Red-DiscordBot | |
| 69 | +| `x.x.x` | Specified version of Red-DiscordBot (e.g. tag `1.2.3` would be Red version `1.2.3`) | |
| 70 | + |
| 71 | +## Environment Variables |
| 72 | + |
| 73 | +| Name | Description | Type | Default | |
| 74 | +| ------------------------- | --------------------------------------------------------------------------------------- | ------- | -------- | |
| 75 | +| `INSTANCE_NAME` | The name of your Red Bot instance.<br>Example: `MyBot` | string | `RedBot` | |
| 76 | +| `PREFIX` | Your bot's command prefix.<br>Example: `!` | string | | |
| 77 | +| `TOKEN` | Your bot token from Discord Developers. | string | | |
| 78 | +| `RPC_ENABLED` | Whether [RPC](https://docs.discord.red/en/stable/framework_rpc.html) is enabled or not. | boolean | `false` | |
| 79 | +| `RPC_PORT` | The port used by Red's RPC server, if enabled. | string | `6133` | |
| 80 | +| `TEAM_MEMBERS_ARE_OWNERS` | Treat Discord Developers application team members as owners. | boolean | `false` | |
| 81 | +| `PIP_REQUIREMENTS` | Optional space-separated list of pip packages to install. | string | | |
| 82 | + |
| 83 | +### Additional Options |
| 84 | + |
| 85 | +If you wish to pass additional options to the `redbot` command, these can be added to the `command` option in [`docker-compose.yml`](docker-compose-example.yml) or appended to the `docker run` command. |
| 86 | + |
| 87 | +> [!WARNING] |
| 88 | +> Do not add arguments which conflict with existing environment variables, such as `--prefix`, `--rpc`, etc. |
| 89 | +
|
| 90 | +> [!TIP] |
| 91 | +> You can see a full list of `redbot` options [here](https://github.com/rHomelab/Red-DiscordBot-Docker/blob/main/.github/redbot-arguments.txt). |
0 commit comments