> ## Documentation Index
> Fetch the complete documentation index at: https://docs.brewbot.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Add BrewBot to your server

> Invite the bot and connect your server to the dashboard.

<Steps>
  <Step title="Sign in to the dashboard">
    Go to the [BrewBot Dashboard](https://brewbot.gg) and sign in with Discord.
  </Step>

  <Step title="Add your server">
    Click **Add server** and select the server you want to manage. If the bot isn't connected yet, you'll be taken directly to the Bot Personalizer setup page.
  </Step>

  <Step title="Authorize permissions">
    Authorize the requested permissions. BrewBot requests only the specific permissions it needs:

    | Permission               | Used for                                                          |
    | ------------------------ | ----------------------------------------------------------------- |
    | **Kick Members**         | AutoMod role enforcement, captcha timeout kicks                   |
    | **Ban Members**          | Captcha verification temp bans                                    |
    | **Manage Channels**      | Channel manager, creating channels from dashboard                 |
    | **Add Reactions**        | Reaction roles                                                    |
    | **View Audit Log**       | Mod logs — identifying who banned, kicked, deleted messages, etc. |
    | **View Channel**         | Required for all features                                         |
    | **Send Messages**        | Welcome messages, mod logs, alerts, verification                  |
    | **Manage Messages**      | AutoMod link blocking, message deletion                           |
    | **Embed Links**          | All embed-based features (mod logs, alerts, etc.)                 |
    | **Attach Files**         | AI voice messages, image generation                               |
    | **Read Message History** | Reaction roles, AI chat context, mod log snapshots                |
    | **Use External Emojis**  | Reaction roles with external server emojis                        |
    | **Mention Everyone**     | Announcement pings in alerts                                      |
    | **Connect**              | Voice features, text-to-speech                                    |
    | **Speak**                | Voice features, text-to-speech                                    |
    | **Manage Roles**         | Reaction roles, captcha verification, leveling rewards            |
    | **Moderate Members**     | Timeout/mute capabilities                                         |
  </Step>

  <Step title="Open your server">
    Once authorized, your server appears in the dashboard sidebar.
  </Step>
</Steps>

<Warning>
  BrewBot no longer bypasses channel or category overwrites. If you want the bot to post in a
  specific channel, make sure the bot role is allowed there.

  For locked or private channels, grant the bot role access in the channel itself or in its parent
  category. In most cases that means allowing at least **View Channel**, **Send Messages**,
  **Add Reactions**, and **Read Message History** for the bot role where the message will be
  posted.
</Warning>

<Note>
  You need the **Manage Server** permission in Discord to add BrewBot.
</Note>

## Checking permissions later

If features aren't working, the bot may be missing permissions. Go to **Configuration > Permissions** in the dashboard to see exactly which permissions are granted and which are missing. If any are missing, use the **Re-authorize Bot** button to update them without removing the bot.

See [Permissions](/features/permissions) for details.