Setup on Server

Initialization process.

Step 1.

To start the setup process, click Add to Discord or Login with Discord/Login (Desktop/Mobile app version) button. You will anyway be redirected to the Discord Login pop-up window.

Step 2.

If you used the Login with Discord/Login button, you will see your Discord avatar icon (and your Discord name on the desktop version). Click it to expand the main user menu and select Dashboard - you will be redirected to the Dashboard page with the list of the servers (guilds) you manage as a server owner or an admin.

Step 3.

On the Dashboard, click the Setup on Server button on the desired server card to launch the bot initialization process.

In the appeared Discord pop-up window, you will see that the server you want to install Bocto to is already chosen from the list. Just press Continue.

In case you've clicked Add to Discord button on Step 1, Step 2, and Step 3 will be skipped, and, after being logged in to Discord, you will then see the next page in the same Discord pop-up window, where you need to choose the server you want to install Bocto to manually. Select one and press Continue.

Step 4.

Grant all the permissions required and click Authorize.

Note: Don't uncheck any boxes if you don't want to encounter problems with some of the bot's features in the future! A comprehensive list of plugins and permissions they use is provided at the end of this page in the Permissions usage section.

Step 5.

After that, the initialization process will start immediately, and you will see its progress in real-time. Usually it takes no longer than 10 seconds.

When the initialization process is finished, you will be automatically redirected to the Settings page. Here you will see the #hub and the #alerts channel that were automatically created and set up for you during the initialization. Also, after the initial setup, there will always be the main red (critical) alert, which says the Bocto position in the roles hierarchy on your server is not high enough to manage users.

In the Bocto #hub channel, you will see the info embedded message with a link to the Dashboard. Also, all news and updates about new plugins and features will be posted here.

In the Bocto #alerts channel, you will see the same critical alert warning you about insufficient Bocto position in the roles hierarchy. All other alerts about insufficient permissions, if any, will be posted here.

Step 6.

Move to the Roles managing section in Discord and lift the bot in the roles list closer to the top. The best but not obligatory position is in the top 3. The main demand is that Bocto should be higher than any role he is going to manage (for example, assigning roles via the Verify Roles or Guard plugin). When done, save changes.

In the #alerts channel, you will see that the issue is resolved. We are now good to go!

Step 7.

Go back to the Settings page in the Dashboard, refresh the page (F5 on your keyboard), and you will see the green message. Now you can move to the plugins list by pressing the All Plugins button.

Note: The All Plugins button will not be clickable until you have a red alert!

UI alerts indication.

If you enter the Bocto Dashboard and see an amber dot on a server card, it means there are issues with Bocto permissions on this server.

On the server management page, you will also see this alert on the Global Settings button as an amber label with a counter that reflects the number of notifications.

On the mobile version, to find the button (and the alert label), you need to expand the sidebar first by clicking on a hamburger icon, which will, by the way, be provided with the same amber alert dot.