# Installation

{% hint style="warning" %}
Ensure that your server meets the requirements. Otherwise, errors may occur during the installation!
{% endhint %}

1. **First**, navigate to the Wale Cloud Dashboard and then to the Download tab. Download the bootstrap file for the master from there.
2. After that, install the **HAProxy service** on your server. This module is **essential** for using the cloud, as it manages the distribution to the individual Minecraft proxy servers through the HAProxy server and a round-robin mechanism.

#### You can use the following command or refer to other documentation to install HAProxy on your server.

{% tabs %}
{% tab title="Ubuntu" %}
{% code title="# Tested on Ubuntu 22.04" %}

```bash
sudo apt install haproxy
```

{% endcode %}
{% endtab %}

{% tab title="Debian" %}
{% code title="# Tested on Debian 12.4" %}

```bash
sudo apt install haproxy 
```

{% endcode %}
{% endtab %}
{% endtabs %}

You must configure the HAProxy. The default config file is located at `/etc/haproxy/haproxy.cfg`

{% hint style="warning" %}
**The haproxy config must be end with the same line like in the following example**
{% endhint %}

```
global
    log /dev/log local0
    log /dev/log local1 notice
    log /dev/log local1 notice
    chroot /var/lib/haproxy
    stats socket /run/haproxy/admin.sock mode 660 level admin
    stats timeout 30s
    user haproxy
    daemon

defaults
    log global
    mode tcp
    option tcplog
    option forwardfor header X-Real-IP
    option dontlognull
    timeout connect 5000
    timeout client 50000
    timeout server 50000

frontend minecraft_front
    bind *:25565
    mode tcp
    default_backend minecraft_servers

backend minecraft_servers
    mode tcp
    balance roundrobin
```

#### After installing the HAProxy service, you can proceed with the installation of the master.

3. Navigate to the dashboard *(Projects > Your Project)* and set the **hostname**, which is the IP address of your **master server**, in your project.
4. Afterward, **navigate** to the *'Configuration'* tab in the dashboard and set the **hostname**, once again the IP address of your **master server**, there.

{% hint style="warning" %}
**Configure the master directly before proceeding with the installation. A detailed explanation of all settings is provided** [**here**](https://docs.walecloud.com/wale-documentation/master-configuration)**.**
{% endhint %}

5. Drag the master bootstrap file onto your server (choose any directory) and execute it. Use the following command. The **'--key' parameter is essential**. You will receive your license key from the dashboard *(Projects > Your Project > License Key)*.

```sh
java -jar bootstrap.jar --key your_license_key
```

{% hint style="info" %}
If your configuration is correct, the cloud will start without errors. You can then proceed with setting up your templates and other configurations. A detailed guide on setting up templates can be found [here](https://docs.walecloud.com/wale-documentation/templates).
{% endhint %}