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

# Add Volvox.Bot to Your Discord Server

> Add Volvox.Bot to your Discord server, log in to the dashboard with OAuth2, and configure welcome messages, moderation, AI chat, tickets, and community tools.

# Getting started

<Callout type="info">
  No installation required. No hosting. No config files on your machine.
</Callout>

<Steps>
  ## Add Volvox.Bot to your server

  Go to [volvox.bot](https://volvox.bot) and select **Add to Server**. The landing-page button starts the Discord invite flow, lets you select a server, and returns you to a setup wizard after approval.

  The bot requests only the permissions it needs. Review them and approve.

  <Callout type="tip">
    You need **Manage Server** permission in the target Discord server to add bots.
  </Callout>

  ## Run the setup wizard

  The Add to Server flow opens a skippable, page-based setup wizard. Focused sections cover welcome messages, content safety, protected roles, warning rules, tickets, reputation, Starboard, command prefix, TL;DR summaries, dashboard roles, and AI provider/model selection. Setup starts with a server selection page that uses the same workspace selector as the dashboard.

  Select the server first, then start setup. The wizard locks that server while you work so channel and role selectors stay scoped to the right Discord server. To configure a different server, use **Back to server selection**, select the server, and start again.

  Turn off any section you don't need, and jump to any step from the wizard step list. Fill in the required choices for the sections you keep on, then save the checklist. The AI provider/model selection applies to AI chat, triage, content safety, and TL;DR routing together.

  If no AI provider credentials are available yet, the wizard still saves the non-AI defaults. You can add provider credentials later and finish the AI pieces from the dashboard.

  <Callout type="tip">
    Skipping setup isn't permanent. Open **Settings** in the dashboard sidebar, then select **Setup wizard** to return to the setup server selector.
  </Callout>

  ## Open the dashboard

  If you come back later, go to [volvox.bot](https://volvox.bot), select **Login with Discord**, and authorize the OAuth2 connection.

  Once logged in, the dashboard opens a server picker when Volvox.Bot isn't yet installed in one of your manageable servers. Server cards show **Manage** when the bot is already present and **Add Bot** when it still needs to be invited.

  The dashboard **Add Bot** flow returns you to the setup wizard after Discord approval. Use **Refresh server list** if Discord hasn't caught up after an invite.

  ## Configure your server

  Open **Settings** in the dashboard sidebar. Here you can:

  * Toggle features on and off
  * Set welcome messages, rules verification, and introduction prompts
  * Set moderation rules and thresholds
  * Configure AI conversation settings
  * Set up ticket panels, staff roles, and transcript channels
  * Customize XP, leaderboards, Starboard, and activity badges

  <Callout type="tip">
    No restarts needed. The bot picks up new config on the next config refresh.
  </Callout>

  ## That's it

  Your bot is live. Explore the dashboard to see analytics, manage moderation, set up tickets, review conversations, and tune settings.
</Steps>

<CardGroup cols={3}>
  <Card title="Dashboard overview" href="/dashboard">
    Learn your way around the dashboard
  </Card>

  <Card title="Moderation" href="/features/moderation">
    Set up AI auto-moderation and moderation rules
  </Card>

  <Card title="Welcome" href="/features/welcome">
    Build your onboarding flow
  </Card>

  <Card title="FAQ" href="/faq">
    Common questions answered
  </Card>
</CardGroup>