# Setup on Server

## <mark style="color:$primary;">Initialization process.</mark>

### <mark style="color:purple;">**Step 1.**</mark>

To start the setup process, click <mark style="color:purple;">**Add to Discord**</mark> or <mark style="color:purple;">**Login with Discord**</mark>/<mark style="color:purple;">**Login**</mark> (Desktop/Mobile app version) button. You will anyway be redirected to the **Discord** Login pop-up window.

<figure><img src="/files/9JxXazMqUyhoaxw7XlZs" alt=""><figcaption></figcaption></figure>

### <mark style="color:purple;">**Step 2.**</mark>

If you used the <mark style="color:purple;">**Login with Discord**</mark>/<mark style="color:purple;">**Login**</mark> 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.

<figure><img src="/files/umsZjc4ML9oerX3j6WU1" alt=""><figcaption></figcaption></figure>

### <mark style="color:purple;">**Step 3.**</mark>

On the **Dashboard**, click the <mark style="color:purple;">**Setup on Server**</mark> button on the desired server card to launch the bot initialization process.

<figure><img src="/files/zZjoE5NiD9GRxxQCXqiI" alt=""><figcaption></figcaption></figure>

In the appeared **Discord** pop-up window, you will see that the server you want to install <mark style="color:purple;">**Bocto**</mark> to is already chosen from the list. Just press <mark style="color:$success;">**Continue**</mark>.

<figure><img src="/files/G3652a52BJ3yiIGCSuuG" alt=""><figcaption></figcaption></figure>

In case you've clicked <mark style="color:purple;">**Add to Discord**</mark> button on <mark style="color:purple;">**Step 1**</mark>, <mark style="color:purple;">**Step 2**</mark>**,** and <mark style="color:purple;">**Step 3**</mark> 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 <mark style="color:purple;">**Bocto**</mark> to manually. Select one and press <mark style="color:$success;">**Continue**</mark>.

<figure><img src="/files/H3FI3LE48GHt4LycVLkn" alt=""><figcaption></figcaption></figure>

### <mark style="color:purple;">**Step 4.**</mark>

Grant all the permissions required and click <mark style="color:$success;">**Authorize**</mark>.

<mark style="color:$danger;">**Note:**</mark> 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**](#permissions-usage) section.

<figure><img src="/files/yh2JdeTVmLnibAn0ZAJq" alt=""><figcaption></figcaption></figure>

### <mark style="color:purple;">**Step 5.**</mark>

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.

<figure><img src="/files/kAKAEE2gSPojjpPhiIjh" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/3sB5KrYDGxD8I9D3xzan" alt=""><figcaption></figcaption></figure>

In the <mark style="color:purple;">**Bocto**</mark>**&#x20;**<mark style="color:yellow;">**#hub**</mark> 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.

<figure><img src="/files/tzeTeb1ARBISWS3oA2QJ" alt=""><figcaption></figcaption></figure>

In the <mark style="color:purple;">**Bocto**</mark>**&#x20;**<mark style="color:yellow;">**#alerts**</mark> channel, you will see the same critical alert warning you about insufficient <mark style="color:purple;">**Bocto**</mark> position in the roles hierarchy. All other alerts about insufficient permissions, if any, will be posted here.

<figure><img src="/files/4H7chA5ewiIySqxEvQZg" alt=""><figcaption></figcaption></figure>

### <mark style="color:purple;">**Step 6.**</mark>

Move to the <mark style="color:$primary;">**Roles**</mark> 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 <mark style="color:purple;">**Bocto**</mark> should be higher than any role he is going to manage (for example, assigning roles via the <mark style="color:blue;">**Verify Roles**</mark> or <mark style="color:blue;">**Guard**</mark> plugin). When done, save changes.

<figure><img src="/files/zDTVlzdFUwAp30oxNt6W" alt=""><figcaption></figcaption></figure>

In the <mark style="color:yellow;">**#alerts**</mark> channel, you will see that the issue is resolved. We are now good to go!

<figure><img src="/files/apMC2EBSCVsQf5jl1rxD" alt=""><figcaption></figcaption></figure>

### <mark style="color:purple;">**Step 7.**</mark>

Go back to the **Settings** page in the **Dashboard**, refresh the page (<mark style="color:$success;">**F5**</mark> on your keyboard), and you will see the <mark style="color:green;">**green**</mark> message. Now you can move to the plugins list by pressing the <mark style="color:purple;">**All Plugins**</mark> button.

<mark style="color:$danger;">**Note:**</mark> The <mark style="color:purple;">**All Plugins**</mark> button will not be clickable until you have a <mark style="color:red;">**red**</mark> alert!

<figure><img src="/files/abSKzV39TgiDTY4j5S7T" alt=""><figcaption></figcaption></figure>

## <mark style="color:$primary;">UI alerts indication.</mark>

If you enter the <mark style="color:purple;">**Bocto**</mark>**&#x20;Dashboard** and see an <mark style="color:orange;">**amber**</mark> dot on a server card, it means there are issues with <mark style="color:purple;">**Bocto**</mark> permissions on this server.

<figure><img src="/files/vbkVwxLbbm1tTFMoULvj" alt=""><figcaption></figcaption></figure>

On the server management page, you will also see this alert on the <mark style="color:purple;">**Global Settings**</mark> button as an <mark style="color:orange;">**amber**</mark> label with a counter that reflects the number of notifications.

<figure><img src="/files/h5IcaPOxGwjL9MkDP0W8" alt=""><figcaption></figcaption></figure>

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 <mark style="color:orange;">**amber**</mark> alert dot.

<div><figure><img src="/files/owWAzPtabUTfY1K9MwBa" alt=""><figcaption></figcaption></figure> <figure><img src="/files/sUAJ3BloVU9Hc4ocl7QN" alt=""><figcaption></figcaption></figure></div>

Here's what a list of different alerts might look like if <mark style="color:purple;">**Bocto**</mark> has multiple permission issues on your server.

<figure><img src="/files/bEwYXtEryhyH0bWp3e4N" alt=""><figcaption></figcaption></figure>

## <mark style="color:$primary;">Permissions usage.</mark>

Below is a comprehensive list of permissions that <mark style="color:purple;">**Bocto**</mark> currently requests, with explanations of which plugins use each permission.

* Manage Roles (Verify Roles, Guard)
* Manage Channels
* Ban Members
* View Channels
* Send Messages
* Send Messages in Threads
* Create Public Threads
* Create Private Threads
* Manage Messages
* Manage Threads
* Embed Links
* Attach Files
* Read Message History
* Add Reactions
* Pin Messages
* Connect


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://guide.bocto.octopeeps.com/getting-started/setup-on-server.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
