Modmail Docs
GitHubDonateSetupDiscord Server
  • Introduction
  • Installation
    • Local hosting / VPS
      • Windows
      • MacOS
      • Docker
      • Ubuntu
      • Debian
      • Fedora
      • Alma Linux
      • Logviewer
      • Patreon logviewer
    • Railway
    • Heroku
    • Community Guides
  • Setting up auto-restart
  • Updating
  • Getting Started
  • Usage
    • Plugins
    • Configuration
    • Permissions
  • Frequently Asked Questions
  • OLD DOCS
    • Installation
    • Installation (continued)
    • Color Names
    • Configuration Variables (Config Vars)
    • Configure Modmail and Logviewer
    • Frequently Asked Questions
    • Modmail Usage
    • Updating
    • Video Tutorials
Powered by GitBook
On this page
  • What you'll need:
  • 1. Heroku Account
  • 2. Discord Bot Account
  • 2.1. Create a bot
  • 2.2. Obtain a token
  • 2.3. Enable Privileged Intents
  • 2.4. Get an invite link
  • 2.5. Invite the bot

Was this helpful?

Edit on GitHub
  1. OLD DOCS

Installation

PreviousOLD DOCSNextInstallation (continued)

Last updated 2 years ago

Was this helpful?

If you need help beyond this tutorial please join our support server and the support team will be happy to help you

Self Hosting Tutorial: https://taaku18.github.io/modmail/local-hosting/

What you'll need:

  • An internet connection and browser.

  • An email account.

  • A digital or physical notepad (Notepad, Notes, ... literally anything).

1. Heroku Account

In this guide, we will be using Heroku to deploy our Modmail bot. Make an account on their to get started.

2. Discord Bot Account

2.1. Create a bot

You will need to create a bot application to interact with the Discord API. Head over to the . Log in - if you're not already - and click on New Application. Give it a name and click Confirm to register your bot.

Discord New Application

A new screen should pop up. Navigate to the Bot section and click on Add Bot. Click on Yes, do it! to confirm.

2.2. Obtain a token

After this, a dashboard for your bot will open. Give your bot a nice profile picture if you want to. It's recommended you switch off the Public Bot option. That way, no one except yourself will be able to add this bot to their server. Lastly, copy the token and paste this in your notepad.

Make sure to keep this token private, since anyone who has it can control (or "hack") your bot and potentially cause malicious damage. If you feel that your token has been leaked, click on Regenerate to invalidate the old one and create a new bot token.

2.3. Enable Privileged Intents

Enable the "Presence Intent", "Server Members" and "Message content" intent within the dashboard.

2.4. Get an invite link

The last thing you need to do in Discord's developer portal is to obtain an invite link for the bot. To do this, head over to the OAuth2 tab. Scroll down a bit and select the Bot section. Scroll a bit further down and you will see a few permissions. Make sure to select View Audit Log, Manage Channels and Manage Messages.

Before you press "copy", scroll down and select the following permissions:

2.5. Invite the bot

Copy the link and paste it in your address bar. A new screen will open: choose your server and select all options. Click on Authorize and your bot should be offline in your server.

Discord Build-A-Bot
Discord Token
Intents
Discord Invite Link
Permissions

To continue the setup, head over to the second page of this guide.
https://discord.gg/cnUpwrnpYb
website
applications page
Discord Invite