Getting Started
Get Azra running in your server and configured in under 5 minutes.
Five steps from zero to a fully configured server.
-
1Invite the Bot
Click Add to Discord on the landing page and select your server. Grant Administrator permission for full functionality — anti-nuke, channel recovery, and captcha need elevated access.
-
2Bot Auto-Provisions Your Server
On first join the bot automatically:
- Creates a guild record in the database
- Grants a free 1-month Pro trial with all features unlocked
- Takes an automatic snapshot of your server structure (channels & roles) — run
/snapshot takeany time for a full backup that also includes emojis, stickers, AutoMod rules, events and server settings - Sets up default moderation configuration
-
3Sign In to the Dashboard
Visit the dashboard URL and click Sign In with Discord. After OAuth, you'll see all servers where you have Manage Server permission. Click your server to open its config panel.
-
4Configure Features
Each feature has its own dashboard page. Navigate via the sidebar to set up moderation rules, welcome messages, leveling, tickets, and more. Changes save instantly — no bot restart required.
-
5Set Up Mod Logging (Recommended)
Go to Server Config and configure a moderation log webhook. Every action — warn, ban, kick, automod trigger — will be posted there as a rich embed. You can route each event type to a different channel.
Discord OAuth2 — no password stored, no separate account needed.
The dashboard uses a server-side session cookie. Your Discord access token is never sent to the browser — only your username, avatar, and user ID.
Every feature has a dedicated configuration page. No commands needed for setup.
| Page | Route | What You Configure |
|---|---|---|
| Server Config | /dashboard/:id | Mod log webhook, per-event routing, subscription card, admin log viewer |
| Moderation | /dashboard/:id/moderation | Native AutoMod: word presets, blocked words, links, invites, mentions; caps & AI moderation toggle |
| Auto Moderation | /dashboard/:id/automod | The 180+ rule engine — anti-raid/nuke, spam, text abuse, links, images, attachments, voice, usernames, profiles; per-rule modes, punishments, exceptions, escalation & test mode |
| Security | /dashboard/:id/security | Anti-nuke limits, raid protection, bot detection, captcha, copy-paste guard, verification |
| Leveling | /dashboard/:id/leveling | XP rates, cooldown, level-up messages, level roles, rank card backgrounds |
| Welcome | /dashboard/:id/welcome | Embed/image/text welcome & goodbye, layered image designer, auto-roles, DM welcome |
| Tickets | /dashboard/:id/tickets | Departments, forms, SLAs, staff, automation, panels, knowledge base, analytics — see the ticket docs |
| Reaction Roles | /dashboard/:id/reaction-roles | Build reaction, button, and dropdown role panels visually |
| Giveaways | /dashboard/:id/giveaways | Create & manage giveaways, bonus entries, server-wide defaults |
| Social | /dashboard/:id/social | Twitch and YouTube integration management |
| Analytics | /dashboard/:id/analytics | 30-day charts: members, messages, joins/leaves, mod actions |
| Sticky | /dashboard/:id/sticky | Per-channel sticky message setup |
| Channels | /dashboard/:id/channels | Create, edit, and delete channels; manage webhooks |
| Subscription | /dashboard/:id/subscription | Start or renew Pro, pick duration, Razorpay checkout |
Most features are configured from the dashboard and used via slash commands, but a curated subset of everyday commands also works as plain text — triggered by your server's prefix or by @mentioning the bot.
Two ways to trigger
!ban @user spamming — using the prefix (default !)@Azra ban @user spamming — by mentioning the bot
Both forms run the exact same logic as the slash command — same subscription gate, same permission checks, and the same entries in your moderation log and audit trail.
Changing your prefix
-
1From Discord
Run
!prefix ?(or@Azra prefix ?) to set the prefix to?. Requires Manage Server. Run!prefixwith no argument to view the current one. -
2From the Dashboard
Go to Server Config and update the prefix field (1–10 characters, no spaces). Changes apply within a few seconds.
Available Text Commands
Run !help in your server for the live list. Commands needing pop-up forms (mass-mod, rank-card background, and creating a giveaway) stay slash-only.
| Command | Aliases | Description |
|---|---|---|
| Moderation | ||
warn <@user> <reason> | — | Warn a member. |
warnings <@user> | warns | View a member's warnings. |
kick <@user> <reason> | — | Kick a member. |
ban <@user|id> <reason> | — | Ban a user. |
unban <id> <reason> | — | Lift a ban. |
timeout <@user> <duration> <reason> | mute | Timeout a member (e.g. 10m, 1h30m, max 28d). |
untimeout <@user> [reason] | unmute | Remove a timeout. |
purge <1-100> [@user] | clear | Bulk-delete recent messages. |
slowmode <seconds> | — | Set channel slowmode (0 to disable, max 21600). |
lock [reason] | — | Lock the current channel. |
unlock [reason] | — | Unlock the current channel. |
| Leveling | ||
rank [@user] | level | Show a rank card. |
leaderboard | lb, top | Top 10 XP leaderboard. |
Giveaways (manager-gated; list open to all) | ||
giveaway list | gw, ga | List active, paused & scheduled giveaways. |
giveaway end <id> | gw, ga | End now and draw winners. |
giveaway reroll <id> [@user] | gw, ga | Reroll all winners, or one. |
giveaway pause <id> / resume <id> | gw, ga | Pause or resume (time preserved). |
giveaway extend <id> <duration> | gw, ga | Add time, e.g. 1h30m (max 60d). |
giveaway cancel <id> | gw, ga | Cancel with no winners. |
| Utility | ||
ping | — | Check bot latency. |
stats | — | Server analytics & moderation summary. |
prefix [new-prefix] | — | View the prefix, or change it (Manage Server). |
help | commands, h | List all available text commands. |
What the bot needs and why.
| Permission | Why it's needed |
|---|---|
| Administrator | Required for anti-nuke (stripping roles), channel recovery, lockdown, and captcha role management. Can be narrowed per feature if you prefer. |
| Manage Channels | Lock/unlock, lockdown, channel recovery from snapshots |
| Manage Roles | Temprole, level roles, captcha verified role, anti-nuke role stripping |
| Ban Members | Ban, tempban, anti-nuke, raid protection ban action |
| Kick Members | Kick, raid protection kick, captcha kick on timeout |
| Moderate Members | Timeout command and auto-mod timeout action |
| Manage Messages | Purge, automod message deletion, sticky message repost |
| View Audit Log | Anti-nuke detection (reads audit log events) |
| Send Messages + Embed Links | Posting mod logs, rank cards, giveaway embeds, welcome messages |
| Add Reactions | Reaction role panels |