Quickstart
Get started with the Discord bot
Last updated
Was this helpful?
Get started with the Discord bot
Last updated
Was this helpful?
A Database & Cache: Use Valkey or Redis for caching (we use Valkey in this guide). The main database must be PostgreSQL.
Server: A server or computer to host the bot, preferably running Linux.
Skills: Basic knowledge of the command line and managing servers.
Permissions: The Manage Server permission in the Discord server where you want to add the bot.
Discord Developer Dashboard access.
A Discord account (obviously).
You can either choose to host everything yourself, or you can use a cloud provider to hose everything for you.
After deciding on how you want to host the bot and its resources, move onto the basic setup and preparation outlined below.
Click the button that says, "New Application".
After clicking the button, give you Discord Bot a name, click the check box, and then click "Create".
Once you click the "Create" button and complete the CAPTCHA, you should see a page like this:
This is the overview page for your Discord bot. Here, you can configure the app icon, the app name, and app description.
In the left navigation pane, click the button that says, "OAuth2".
Once you click the button, you should see a page that looks like this:
Underneath the section that says, "Client Information" where it says "Client ID", click on the "Copy" button. Save this number as we'll need it for later.
Next, scroll down to this section:
Check the checkbox next to where it says, "bot". Scroll down. Under the "Bot Permissions" section, click the checkbox for "Administrator" under the "General Permissions" section. Next, scroll down again and for the "Intergration Type" dropdown, make sure it says, "Guild Install". In the end, your configuration should look something like this:
Click "Copy" next to "Generated URL".
Open a new browser tab, pase in the link, and press Enter. You should then see a screen where you can invite the bot into a Discord server. Select your Discord server from the dropdown menu and click "continue".
On the next screen, click "Authorize" and if prompted, complete multifactor authentication and the CAPTCHA.
If everything was successful, you should see a success message like the one below.
The discord bot was successfully added to your selected Discord server. You can now continue with the rest of the guide.
Click the button on the left navigation pane that says, "Installation".
After you click on the button, you'll be greeted by a page that look something like this:
First, uncheck the checkbox next to "User Install". Next, select "None" from the "Install Link" dropdown (click where it says "Discord Provided Link"). Finally, click "Save" at the bottom of the screen. When you're done, your screen should look like this:
Now, it's time to configure the actual Discord bot.
Click the button on the left navigation pane that says, "Bot".
After clicking on the "Bot" tab, you'll see a page like this:
Here, you can configure things such as the username, banner, and icon of your bot. Scroll down to the section that looks like this:
Deselect the "Public Bot" option and choose all other options. Make sure to click "Save". Your screen should resemble this:
Next, scroll back up to this section:
Underneath the "Token" header, click on the button that says, "Reset Token".
Click "Yes, do it!" on the dialogue that pops up.
Follow the multifactor authentication steps, and once complete, you should see a screen like this:
WARNING: DO NOT SHARE YOUR BOT TOKEN WITH ANYONE. Treat your bot token like a password. If someone gets access to your bot's token, they'll have unrestricted access to your bot and Discord server, meaning they can do anything that they want. Store this token in a safe place as you won't get to see it again and will have to regenerate it.
Copy your bot token and save it somewhere safe. We'll need it later.
If you've made it this far without getting lost, give yourself a pat on the back. Before we move onto the fun stuff, we have to gather one some last bits of information from our Discord server.
Head on over to and click on the settings icon next to your username.
Next, scroll down on the left navigation pane and click "Advanced".
Find the option that says, "Developer Mode" and turn that on. Once you are done, your screen should look like this:
Exit settings and navigate to your Discord server. On the left server selector pane, right click on your Discord server and click the "Copy Server ID" button on the bottom of the options menu. This is what's known as your "Guild ID". Save this ID as we'll need it later.
Next, in your Discord server, right click on your logs channel and click the "Copy Channel ID" button. Repeat this for your welcome channel.
Lastly, click on your server's name at the top and click on "Server Settings".
Then, click on the "Roles" button in the left navigation pane and find the role(s) that you want to assign to people as soon as they join your server. Right click on each role and select "Copy Role ID". Save these ID's as we'll need them later when configuring the bot.
We are now done with the preparation for our Discord bot. It's now time to setup and deploy the Discord bot and its services. Based on your decision in Step 0, click on the corresponding link to take you to the rest of the quick start guide.
