> For the complete documentation index, see [llms.txt](https://docs.lidistat67.eu/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.lidistat67.eu/installing-dependencies.md).

# Installing dependencies

## On your computer

### Putty

#### Windows

Install PuTTY on Windows directly from [here](https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html).

#### Linux

{% hint style="warning" %}
It is not recommended to use PuTTY on Linux.
{% endhint %}

Enable the universe repository using:

```
sudo add-apt-repository universe
```

Install PuTTY by using:

```
sudo apt install -y putty
```

You can open PuTTY by running `putty` on the terminal or you can manually search for the application.

#### Mac

{% hint style="warning" %}
It is not recommended to use PuTTY on MacOS.
{% endhint %}

Install XCode developer tools from the app store [here](https://apps.apple.com/us/app/xcode/id497799835) and run these two commands.

```
xcodebuild -license
```

```
xcode-select --install
```

Install XQuartz from [here](https://www.xquartz.org/).

Install PuTTY by running this command

```
sudo port install putty
```

Run putty by using `putty`

### Termius

#### Windows and Mac

Install Termius directly from [here](https://termius.com/free-ssh-client-for-windows) for Windows or [here](https://termius.com/free-ssh-client-for-mac-os) for Mac.

#### Linux

Install Termius by running the command below otherwise you can install the .deb package from [here](https://termius.com/linux) if you are on a debian-based distro (Ubuntu, Debian, Linux Mint, etc).

```
sudo snap install termius-app
```

{% hint style="info" %}
If you don't have Snap installed, you can find instructions on how to download it [here](https://snapcraft.io/docs/installing-snapd).
{% endhint %}

## On your VPS

{% hint style="danger" %}
If at any time during installing dependencies the "(package name) has no installation candidate/(package name) is not available" error appears, your apt version is outdated as explained below. Run "sudo apt update && sudo apt upgrade" to fix this issue.
{% endhint %}

### Upgrading the system

It is necessary to update the system before proceeding.

Start by updating the repositories:

```
sudo apt update
```

Then upgrade all packages:

```
sudo apt upgrade
```

{% hint style="info" %}
If "Pending kernel upgrade" or "Daemons using outdated libraries" appears, hit Enter.
{% endhint %}

Once apt has finished upgrading, reboot the VPS:

```
sudo reboot
```

Wait \~1 minute for the reboot to finish then reconnect to your VPS.

Sometimes apt doesn't get upgraded. To avoid this, upgrade the system once more.

```
sudo apt update
```

Then:

```
sudo apt upgrade
```

### Pip and pipenv

Install pip by running:

```
sudo apt install python3-pip
```

Install pipenv by running:

```
sudo pip install pipenv
```

### PM2

{% hint style="warning" %}
If you're not planning on using PM2, skip this section. PM2 is required for keeping your bot alive 24/7.
{% endhint %}

Start by installing node.js and npm:

```
sudo apt install nodejs npm
```

{% hint style="info" %}
npm depends on a considerable amount of packages. Expect this to take some time.
{% endhint %}

Install pm2 by running:

```
sudo npm i -g pm2
```

### libcairosvg

Install libcairosvg by running:

```
sudo apt install libpangocairo-1.0-0
```