Adding Arclo
Invite the bot, give it the permissions it needs, put its role in the right place, and confirm it is working, in about two minutes.
You need Manage Server in the server you are adding Arclo to. Discord only shows servers you hold that permission in on the invite screen.
Invite the bot
Open the invite link
Use the Add to Discord button anywhere on this site, or go straight to the invite page.
Pick the server
Choose it from the dropdown. If the server is not listed, you do not have Manage Server there. Ask an admin to add Arclo, or to give you the permission.
Leave the permissions ticked
The invite asks for Administrator and, alongside it, every individual permission Arclo uses. That is deliberate: Administrator means nothing can fail later over a box somebody forgot, and the individual grants mean you can untick Administrator (on this screen, or on Arclo's role at any point afterward) and still have a fully working bot rather than one that does nothing. The one catch is channel tickets: without Administrator they need a ticket category picked in the dashboard (see Ticketing). If you would rather grant less than that, trim Arclo's role in Server Settings → Roles after authorizing: Permissions Arclo needs lists exactly what each system uses and what stops working without it.
Authorize
Arclo joins immediately and appears in your member list, and Discord sends you back to this site, which opens the new server's dashboard. (If the server is not ready a second or two later, you land on the server picker instead, where it shows up as soon as the bot has joined.)
Nothing happens yet. That is deliberate
A freshly added Arclo does not moderate, log, greet, level or announce anything. Every system starts switched off, so adding the bot to try tickets cannot quietly start deleting messages. The one thing it sends is a single welcome message with links to the dashboard and to /help: by DM to whoever added it, or to the server owner if that fails, and only as a last resort in the server's system channel (or the first channel it can post in).
Move Arclo's role up
This is the single most common cause of “the bot is not working”, and it takes ten seconds to fix.
Discord will not let any bot act on a member whose highest role is above the bot's own. Arclo cannot ban, mute, kick, or add a role to somebody who outranks it, and it cannot hand out a role that sits above its own role in the list.
Open Server Settings → Roles
Find the role Discord created when Arclo joined. It is called Arclo and is managed by the integration.
Drag it above the roles it has to manage
As a rule: above every member and moderator role, below your owner/admin roles. It does not need to be at the very top.
Roles Arclo cannot reach are invisible to it
Role pickers in the dashboard warn on any role above Arclo's (hover it to see why), and the Settings page shows a warning banner when Arclo has no Manage Roles at all. If a reward role never lands, check the ladder first.
Open the dashboard
If you added Arclo from this site you are already there. Otherwise:
Log in with Discord
Click Login with Discord in the top-right of this site. Arclo asks Discord for your identity and your server list, nothing else.
Pick your server
The picker lists every server you own or hold Administrator in, plus any where you were given dashboard access explicitly (a Bot Master role or a page access rule, see Who can change settings). Manage Server on its own is not enough. A crown marks servers you own, a key marks access through a Bot Master role, and servers without Arclo show an Add button instead of Manage.
Welcome back, mira.
Open a server Arclo is already in, or add it to a new one. You only see servers where you have admin rights or were given dashboard access.
Ready to manage
2Nebula Collective
Active
Pixel Foundry
Active
Available to add
1The Lounge
Not added
Check it is alive
Type /about in any channel Arclo can see. You should get a private reply saying how many systems are on in your server (none yet), its ping and uptime, and its links. If the command does not appear in the slash menu at all, Discord has not finished syncing the command list. Give it a minute, then reload Discord with Ctrl + R.
Then go set something up
Your first 15 minutes walks through the seven systems most servers want on day one.
Removing Arclo
Kick the bot like any member. Its commands disappear from your server within a minute or two.
Removing Arclo deletes your configuration after 14 days
When Arclo is removed from a server, that server's stored settings and data (every system's configuration, levels, cases, tickets and counters) are marked for deletion and removed permanently 14 days later. Re-add the bot inside those 14 days and everything comes back exactly as it was. After that it is gone and cannot be recovered. Backups, templates and chat logs are stored outside the deletion on purpose and survive either way. If you are only troubleshooting, you still do not need to kick the bot: switch the system off instead.
Re-adding Arclo inside the 14 days brings back every setting and its commands, and it sends its welcome message again. Two things do not come back, because Discord removed them with the bot:
- Its role. Discord gives Arclo a brand-new role at the bottom of the list, below every role it hands out. Drag it back up (step 2 above) or role rewards, auto roles and mutes stop working.
- Channel permissions set on Arclo itself. That is how it reached existing ticket channels, so without Administrator it can no longer see the tickets that were open. The welcome message lists the permissions your switched-on systems are missing and any open tickets it cannot see.
Still stuck? Ask in the support server: somebody there has almost certainly configured this before.
