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

# Required Permissions

> Understand the permissions Flare needs to operate securely and effectively.

## Overview

For Flare to keep your server safe from raids, nukes, and rule-breakers, it must have the appropriate Discord permissions. If Flare lacks permissions, its core features (like AntiNuke, AutoMod, and Moderation) will fail to execute.

## The Golden Rule: Role Hierarchy

<Warning>
  **CRITICAL:** Flare **cannot** punish users who have a role higher than its own.

  You must drag the `Flare` role to the **very top** of your server's role list in Discord settings (`Server Settings > Roles`). If Flare's role is below a rogue admin, AntiNuke will fail to ban them.
</Warning>

***

## Recommended Permissions

When you invite Flare, it requests the **Administrator** permission by default.

### Why Administrator?

Flare handles everything from channel deletion (AntiNuke) to role assignment (Welcome) and message filtering (AutoMod). The Administrator permission guarantees that Flare can execute these actions flawlessly without you manually hunting down specific channel overwrites.

If you are uncomfortable granting Administrator, you must manually grant the following permissions to Flare's role:

<AccordionGroup>
  <Accordion title="Security & Moderation (Required)">
    * `Ban Members`
    * `Kick Members`
    * `Moderate Members` (For timeouts/mutes)
    * `Manage Messages` (For AutoMod and purge commands)
    * `Manage Roles` (For assigning mute/jail roles)
  </Accordion>

  <Accordion title="VoiceMaster (Required if used)">
    * `Manage Channels`
    * `Move Members`
  </Accordion>

  <Accordion title="AntiNuke (Required if used)">
    * `View Audit Log`
    * `Manage Webhooks`
  </Accordion>
</AccordionGroup>

***

## Troubleshooting Permissions

If a command fails or a module isn't triggering, it is almost always a permission issue.

<Steps>
  <Step title="Check the Role Hierarchy">
    Ensure Flare's role is above the target user's role.
  </Step>

  <Step title="Check Channel Overrides">
    If Flare can't delete messages in `#general`, check if `#general` has channel-specific permissions denying `Manage Messages` for the Flare role.
  </Step>

  <Step title="Verify 2FA Requirement">
    If your server requires Two-Factor Authentication for moderation, ensure the server owner has 2FA enabled, otherwise Flare's admin actions might be blocked by Discord.
  </Step>
</Steps>