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

# Kerb

Event distributor server software.

## Step 1

Create a new server or node.

> If you are using Pterodactyl you can use the Kerb egg located here <https://github.com/Kerbity/Kerb/blob/main/egg-kerb.json>

## Step 2

Download the Kerb Software:

{% embed url="<https://github.com/Kerbity/Kerb/releases>" %}

## Step 3

Create the client and server certificates for SSL.

* First open the terminal and `cd` into your chosen directory.
* Then run the following commands to create the certificates.
* Use the same password for each and save it for later.

{% code overflow="wrap" %}

```
openssl req -newkey rsa:2048 -nodes -keyout server-key.pem -x509 -days 365 -out server-certificate.pem
```

{% endcode %}

{% code overflow="wrap" %}

```
openssl req -newkey rsa:2048 -nodes -keyout server-key.pem -x509 -days 365 -out server-certificate.pem
```

{% endcode %}

{% code overflow="wrap" %}

```
openssl pkcs12 -inkey client-key.pem -in client-certificate.pem -export -out client-certificate.p12
```

{% endcode %}

{% code overflow="wrap" %}

```
openssl pkcs12 -inkey server-key.pem -in server-certificate.pem -export -out server-certificate.p12
```

{% endcode %}

* Add the two certificate files to the server and clients.

## Step 4

Run the server to generate the config file:

```
java -Xms128M -Dterminal.jline=false -Dterminal.ansi=true -jar Kerb-1.0.0.jar
```

## Step 5

Configure kerb so all clients and servers have the same password.

## All done!

You should now have a working kerb server! if you get any errors feel free to ask questions in the discord.&#x20;

<https://discord.gg/pax7uFhaaD>