Skip to content
Docs menu: Permissions

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-logs made 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

PermissionWhy Bastion needs itUsed by
View Audit LogTo 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 RolesTo 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 ChannelsTo 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 ServerTo pause invites during a raid.Anti-Raid
Kick MembersTo 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 MembersTo ban and unban.Anti-Raid, Join Gate, Anti-Nuke, /ban, /unban, /lockdown joins
Timeout MembersTo time out spammers. Discord also calls this Moderate Members.Automod, Join Gate, /timeout, /untimeout, warn steps
Manage MessagesTo delete spam and to clear messages in bulk.Automod, /purge
Manage WebhooksTo delete a webhook that's being used for spam.Automod
View ChannelsTo see the channels it protects.Everything
Send MessagesTo post logs, including message logs, the welcome message and the Verify button.Logs, Verification
Embed LinksTo post log entries and the Verify message as tidy cards.Logs, Verification
Attach FilesTo show the captcha picture.Verification
Read Message HistoryTo 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

  1. Open Server Settings, then Roles

    Select the Bastion role and open its Permissions tab.

  2. Tick Administrator

    Save changes.

  3. Press Fix permissions

    Run /status and 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 clean or 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