> For the complete documentation index, see [llms.txt](https://katzumi.gitbook.io/katzumi-docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://katzumi.gitbook.io/katzumi-docs/guide/installation-and-settings.md).

# Installation and settings

{% hint style="warning" %}
You must have the ***Manage Server*** or ***Administrator*** permission to add a bot to a server.
{% endhint %}

## Invite the bot

Let's start by inviting Katzumi to the server with the [**invite link.**](https://katzumi-bot.vercel.app/invite)

<figure><img src="/files/jctc5qvAHsJSC3TAs5xa" alt=""><figcaption><p>Choose your server, press "continue", then scroll down and press "allow"</p></figcaption></figure>

{% hint style="success" %}
Congratulations, `Katzumi` is now added to your server !
{% endhint %}

## Installation

Once Katzumi is added to your server, you need to give it the permissions it needs. To do this, start by going to your server settings, in the Roles category.

{% hint style="info" %}
Depending on the permissions you grant to Katzumi, some commands will no longer be usable due to the lack of permission(s).
{% endhint %}

#### Permissions

| Optional                                                                    |
| --------------------------------------------------------------------------- |
| <mark style="color:green;">Administrator (recommended)</mark>               |
| <mark style="color:orange;">View Audit Log (necessary)</mark>               |
| <mark style="color:orange;">Create Invites (necessary)</mark>               |
| <mark style="color:orange;">Ready Messages/View channels (necessary)</mark> |
| <mark style="color:orange;">Send messages (necessary)</mark>                |
| <mark style="color:orange;">Embed Links (necessary)</mark>                  |
| <mark style="color:orange;">Attach Files (necessary)</mark>                 |
| <mark style="color:orange;">Read Messages History (necessary)</mark>        |
| <mark style="color:orange;">Use External Emojis (necessary)</mark>          |
| Add Reactions                                                               |
| Manage messages                                                             |
| Manage Emojis and Stickers                                                  |

{% hint style="success" %}
Thanks to this installation and if you have chosen to trust `Katzumi` by leaving it <mark style="color:green;">Administrator</mark>, you should not encounter any problem. The primary installation is now complete. The next step is “[Configuration](/katzumi-docs/guide/configuration.md)”.
{% endhint %}


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## 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://katzumi.gitbook.io/katzumi-docs/guide/installation-and-settings.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.