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

# Get Percy Running on Your Discord Server in Under 5 Minutes

> A complete walkthrough for inviting Percy to your Discord server, granting the right permissions, and running your first Percy commands.

Getting Percy up and running on your server takes less than five minutes. You'll invite the bot, confirm its permissions, verify it's online with a quick test command, and then set up your first feature. No configuration files, no hosting — just click, invite, and go.

<Steps>
  <Step title="Invite Percy to Your Server">
    Click the link below to open Discord's official OAuth2 invite flow. Select the server you want to add Percy to from the drop-down menu, then click **Authorize**.

    [**Invite Percy →**](https://discord.com/api/oauth2/authorize?client_id=1070054930125176923)

    <Note>
      You need the **Manage Server** permission (or be the server owner) to add a bot to a Discord server.
    </Note>
  </Step>

  <Step title="Grant the Required Permissions">
    The invite link requests a default set of permissions that cover Percy's core features. Review the permissions dialog and click **Authorize** to confirm.

    If you'd like to limit Percy's access, you can uncheck individual permissions — just be aware that some features won't work without their required permissions. See the [Permissions guide](/docs/permissions) for a full breakdown by feature.

    Once you authorize, Percy will appear in your server's member list and its slash commands will register automatically within a few seconds.
  </Step>

  <Step title="Verify Percy Is Online">
    Head to any channel Percy can read and write in, then run a quick ping test. Percy should reply instantly with its current latency.

    <CodeGroup>
      ```text Slash command theme={null}
      /ping
      ```

      ```text Prefix command theme={null}
      ?ping
      ```
    </CodeGroup>

    If Percy doesn't respond, double-check that it has **Send Messages** and **View Channel** permissions in that channel.

    <Tip>
      Not sure which commands exist? Run `/help` or `?help` for a full, paginated overview of every command category. Use `/help <command>` to get detailed usage and examples for any specific command.
    </Tip>
  </Step>

  <Step title="Set Up Your First Feature — Moderation">
    Percy's moderation suite is one of the most common first things to configure. Run the moderation config command to open an interactive panel that walks you through logging channels, mute role setup, and automod rules.

    <CodeGroup>
      ```text Slash command theme={null}
      /moderation
      ```

      ```text Prefix command theme={null}
      ?moderation
      ```
    </CodeGroup>

    The interactive menu lets you enable or disable individual moderation features, assign a dedicated log channel, and bind a mute role — all without leaving Discord.

    Here's a quick taste of what moderation commands look like in both styles:

    <CodeGroup>
      ```text Slash — ban a user theme={null}
      /ban user:@Username reason:Spamming duration:7d
      ```

      ```text Prefix — ban a user theme={null}
      ?ban @Username 7d Spamming
      ```
    </CodeGroup>

    <Tip>
      Every Percy command works as both a slash command and a prefix command. Slash commands offer autocomplete and guided argument input; prefix commands are faster to type once you know them. Use whichever you prefer — they're identical under the hood.
    </Tip>
  </Step>
</Steps>

## What's Next?

Once Percy is in your server and responding to commands, you're ready to explore the rest of what it offers.

* **Browse all commands** — run `/help` or `?help` in any channel.
* **Manage settings visually** — visit the [Percy Dashboard](https://percy.klappstuhl.me/dashboard/) to configure your server from a web interface.
* **Get help anytime** — join the [Percy Support Server](https://discord.gg/3jSYQ9VNbA) if you have questions or run into issues.

<Note>
  Percy's default prefix is `?`. Your server admin can change it to any custom prefix — check with your server admin or run `/config prefix` to update it.
</Note>