Skip to content
Setup guide

Set up EvaluBot and run your first audit

Add EvaluBot to your Discord server, run /audit, and open the report in your browser. That is the whole setup. This guide walks through each step, how to read and act on the report, and how to turn on live permission alerts.

By Digital DenUpdated November 14, 20266 min read

Step 1

Add EvaluBot to your server

Click Add to Discord, pick your server, and authorize. Discord only lists servers where you have Manage Server. EvaluBot asks for Administrator, so it can audit every channel, including the private ones Discord hides from bots from 16 November 2026. Its audits and alerts only read. Prefer fewer permissions? Pick a link on the permissions page: without one, only the matching section or feature is limited, and EvaluBot says so. Here is what each permission is for:

View Channelsread-only

Read the server's channel structure.

View Audit Logread-only

Show who last changed a privileged role, name who made each change in an alert, see members being given roles, new webhooks and bots, kicks and prunes, spot one account doing damage and security bots being removed, list recent risky actions, and find who added EvaluBot.

Manage Webhooksread-only

List the server's webhooks. Discord requires it to read them.

Ban Membersread-only

Read the ban list. Discord requires it to read bans. Never used to ban.

Manage Serverread-only

List active invites, integrations and server templates and read AutoMod rules (Discord requires it to read them), and tell bots from people in role member counts.

Send Messagesposting

Post permission alerts and recurring audit reports in the channel an admin picks, and the welcome message if the person who added EvaluBot cannot be DMed.

Embed Linksposting

Alerts and reports are sent as embeds.

Attach Filesposting

Attach the report file to each recurring audit.

Once it joins, EvaluBot DMs whoever added it with a short welcome and the links you need. If that DM cannot be delivered, it posts the welcome once in your server's system channel instead.

Step 2

Run your first audit

In any channel, run /audit. You get a PDF report that opens with one click. Set format to HTML for the interactive report that opens in a browser, or to JSON for the raw data for your own tools.

/audit

A live progress bar shows each step. If many audits are running, you see your place in the queue and an estimated start time, and it starts on its own. To audit only part of the server, add sections, such as roles,channels; it suggests the next section as you type. When an audit would use the server's last one of the month, EvaluBot asks before it runs.

When it finishes, the Audit complete message gives the score and its grade, the three deductions that cost the most with the step that clears each one, and what to do next.

Your free audit for the month

Every server gets 1 free audit a month, and it only counts once the report reaches you. The allowance belongs to the server and resets on the 1st at 00:00 UTC. Premium raises it to 15.

Step 3

Open your report

The report arrives in a reply only you can see, with a copy in your DMs. A PDF opens with one click. Discord's file preview shows the raw code of an HTML file, not the styled report, so for HTML:

  1. 1Use Discord's download button on the report file. EvaluBot's reply includes a screenshot showing where it is.
  2. 2Open the downloaded file in any web browser. On a phone, open it from your downloads or files app.
  3. 3Read it, print it, or keep it. It is one self-contained file, and dates show in your own time zone.

Download it soon

Discord removes private replies when the app reloads, which is why EvaluBot also sends a copy to your DMs. Report files are deleted from the bot host after 24 hours. The copy you downloaded is yours to keep.

Reports over Discord's 25 MB upload limit arrive as a .zip. Unzip it first, then open the report file inside.

Step 4

Fix what it found

Start at the Security Score. Every deduction lists its point cost, severity and how to fix it, so work from the critical ones down. Then go through the recommendations, grouped Critical, General and Optional, each written as a problem and a fix.

The fixes are changes you make yourself in Discord: the audit is read-only and never changes anything. With Premium, /auditfix plan turns what costs the server points into a checklist that ticks itself off as you fix things, without using an audit, and /auditchannels can make many of the channel fixes at once, such as syncing channels with their category or making channels read-only, after showing you every change. A risk you live with on purpose can be accepted with /auditfix accept, so it stops costing points while staying listed in every report. For the most common ones, see the security checklist, how to close the thread loophole and what each dangerous permission can do.

Your next audit shows the score change since this one, and how many settings changed: new risks, items to review, fixes and other changes.

Step 5

Turn on permission alerts

Audits show how the server looks today. Alerts tell you when that changes. Make a staff-only channel, then run:

/auditmonitor setupchannel#staff-alertsping_role@Moderators

EvaluBot checks it can post there, and names anything missing. The server owner also gets each alert by DM. Only the owner can turn that off, by setting dm_owner to false, and then EvaluBot does not DM them about alerts at all. Run /auditmonitor test to see a test alert arrive in every place alerts go.

Every server gets the critical alerts: Administrator granted anywhere, takeover permissions on @everyone, ownership transfers, raids, mass deletions and creations, members removed in bulk, and one account doing damage. Premium adds every other risky change, such as staff permissions, lowered protections, private channels opened up, new webhooks and bots. See every alert.

Step 6, optional

Schedule and look back

Run /auditschedule once to run an audit later, with the report sent by DM. Say when the way you would, such as tomorrow 9am, and pick your time zone once: EvaluBot remembers it.

/auditschedule oncewhentomorrow 9am

Check past scores with /audithistory, and share the latest one with /auditcard. With Premium, /auditschedule recurring posts a report to a staff channel every week or month. Every option is on the commands page.

Troubleshooting

A section says it could not be read
EvaluBot is missing the permission that section needs: Manage Server for AutoMod, Invites and Integrations, Manage Webhooks for Webhooks, Ban Members for Bans, and View Audit Log for Recent Activity. Grant it on EvaluBot's role in Server SettingsRolesEvaluBot and run the next audit. Missing sections never cost points.
"Last changed by" or alert authors show as unknown
EvaluBot needs View Audit Log to name who made a change.
The report says some channels are hidden
Discord only shows a bot the channels it can view. Give EvaluBot Administrator, or give its role View Channel in those channels or their categories, and the next audit includes them. Hidden channels never cost points.
The report says some parts were left out for you
A report shows you only what Discord shows you. Without Administrator, channels you cannot see, the ban list (without Ban Members), webhooks (without Manage Webhooks) and the audit log (without View Audit Log) are left out. The score still covers the whole server. Someone with Administrator gets the full report.
The report did not reach my DMs
Your DMs from that server are closed. Download the report from the private reply straight away, or allow DMs in the server's privacy settings.
I was asked to wait, or to try again later
Only one audit runs per server at a time, so a second one waits, and EvaluBot says what is holding it up and where it is in line. If the queue is full, try again in a few minutes. Nothing is counted.
The server has used its audit this month
The allowance resets on the 1st at 00:00 UTC. Check usage with /auditplan, or open a ticket in the support server to request more. Premium gives the server 15 audits a month.

FAQ

Do I need to be an admin to add EvaluBot?

Discord only lets people with Manage Server add apps to a server. Once it is in, its commands are for the server owner and members with Administrator.

How do I open an EvaluBot report?

A PDF report, the default, opens with one click in Discord or any PDF viewer. For an HTML report, Discord's preview shows the raw file, so download it with Discord's download button, then open the downloaded file in any web browser. Either way it is one self-contained file, so it works offline and prints cleanly.

Why did EvaluBot not DM me my report?

Your DMs from that server are probably closed. The private reply still has the report, and tells you to download it straight away, because Discord removes private replies when the app reloads.

What should I fix first?

The deductions in the Security Score, starting with critical ones like 2FA for moderators and dangerous @everyone permissions, then the Critical recommendations. Each one comes with its fix.

Ready when you are.

Add EvaluBot, run one command, and get a scored report with every fix explained. Read-only from start to finish.

Join the Discord servers already running EvaluBot.

Running a busy server? Premium gives it 15 audits a month, every risky change as an alert, fix plans and more. See Premium