Reference
Permissions
In short
Bastion asks for Administrator, because a channel locked to a role is hidden from any bot without it. Then press Fix permissions in /status or on the dashboard, and Bastion sets up the rest itself.
Why Administrator
Most servers lock some channels to a role: staff chat, logs, members-only areas. Discord hides a locked channel from every bot that isn't let in, whatever other permissions it has. Bastion can't watch a channel it can't see, can't post its logs there, and can't fix that channel's permissions.
Administrator is the only permission that reaches every channel. So that's what the invite asks for. Bastion uses it to do the jobs in the table below, and nothing else.
CarefulAdministrator is a lot of power, so only add Bastion from the official website. Bastion never asks for your password, and nobody from Bastion will ever ask you to give a bot access.
Fix permissions
One button puts Bastion's own setup right. Press it under /status in Discord, or on the Overview page of the dashboard. It's safe to press again and again: anything already right is left alone.
- Quarantine role: made if there isn't one, and hidden from every channel.
- Log channel: a private
bastion-logsmade if you don't have one. - Channels Bastion posts in: your log channels, the verify channel, the honeypot, reports and appeals. Bastion lets itself post in any of them that block it.
- Honeypot: threads and reactions turned off in it, and its warning pinned. See the honeypot.
It then says what only you can do. Two things can't be fixed by a bot: giving Bastion Administrator, and moving its role to the top of the list.
In Discord, the server owner, trusted people and administrators can press it. On the dashboard, the owner and trusted people can.
What Bastion uses it for
| Permission | Why Bastion needs it | Used by |
|---|---|---|
| View Audit Log | To see who deleted a channel, banned a member, changed a role or added a bot. Without it, anti-nuke can't tell who did what and every new bot is treated as unauthorised. | Anti-Nuke, Join Gate |
| Manage Roles | To remove roles and give the Quarantined role, hand out the verified role, undo dangerous permission changes, lock channels and rebuild roles. | Quarantine, Verification, Lockdown, Backups |
| Manage Channels | To lock and unlock channels, set slowmode, hide channels from the Quarantined role, create the bastion-logs channel and rebuild deleted channels. | Lockdown, Backups, /slowmode, /setup |
| Manage Server | To pause invites during a raid. | Anti-Raid |
| Kick Members | To remove raid accounts, unauthorised bots, bots that go over an anti-nuke limit, people who don't verify in time and anyone you kick by command. | Anti-Raid, Join Gate, Anti-Nuke, Verification, /kick |
| Ban Members | To ban and unban. | Anti-Raid, Join Gate, Anti-Nuke, /ban, /unban, /lockdown joins |
| Timeout Members | To time out spammers. Discord also calls this Moderate Members. | Automod, Join Gate, /timeout, /untimeout, warn steps |
| Manage Messages | To delete spam and to clear messages in bulk. | Automod, /purge |
| Manage Webhooks | To delete a webhook that's being used for spam. | Automod |
| View Channels | To see the channels it protects. | Everything |
| Send Messages | To post logs, including message logs, the welcome message and the Verify button. | Logs, Verification |
| Embed Links | To post log entries and the Verify message as tidy cards. | Logs, Verification |
| Attach Files | To show the captcha picture. | Verification |
| Read Message History | To find recent messages when you purge. | /purge |
Permissions are only half of it
A permission says what Bastion may do. Role position says who it may do it to. A bot with Ban Members still can't ban someone whose top role is above the bot's own.
CarefulDrag the Bastion role to the top of your role list. With every permission but a low role, Bastion can't stop an admin. See the setup guide.
If you added Bastion before it asked for Administrator
Open Server Settings, then Roles
Select the Bastion role and open its Permissions tab.
Tick Administrator
Save changes.
Press Fix permissions
Run
/statusand press the button, or press it on the dashboard's Overview page.
Without Administrator, Bastion still needs every permission in the table, and /status names any that are missing. It's worth 10 points on your security score. Fix permissions then fixes what it can and tells you which channels are still hidden from it.
What Bastion never does with it
- Rename people. Administrator includes Manage Nicknames, but Bastion only changes a nickname when you run
/nick cleanor switch on Clean up unreadable nicknames. - Ping everyone. Bastion never pings your whole server.
- Read private messages. No bot can read those.
Can I give Bastion named permissions instead of Administrator?
You can tick every permission in the table instead. Bastion then works everywhere it can see, but any channel locked to a role stays hidden from it until you let it in.
Why does a security bot need to manage roles?
Quarantine works by removing roles. Without Manage Roles, Bastion could only kick or ban, and those are much harder to undo.
Is it safe to give a bot this much power?
It's a fair question. Bastion needs the same powers an attacker would use, because stopping them means acting faster with the same tools. Only invite Bastion from the official website.
I ticked Administrator and it still says something is wrong.
Run /status again so Bastion rechecks, then press Fix permissions. If Bastion's role isn't at the top, that's the one thing it can't do for you.
Last updated