Installing Gunbot on Linux

note

This guide, written for Ubuntu 22.04.1 server version, provides step-by-step instructions for setting up Gunbot on Linux. While the focus is on Ubuntu, the steps are largely applicable to other Linux distributions. Desktop users can follow along using their integrated terminal.

Basic Linux instructions

Download the latest Gunbot release from here. Extract gunthy_linux.zip on your computer.

In the terminal, navigate to the Gunbot folder and set permissions:

cd /home/Gunbot
chmod +x gunthy-linux

Then start running the process:

./gunthy-linux

Access the Gunbot GUI at http://localhost:3000

Setting Up a VPS (Optional)

For those who prefer using a VPS, here are some popular choices among Gunbot users:

• Hetzner Cloud
• DigitalOcean
• Vultr
• Contabo

After signing up and ordering a Linux VPS, you'll receive an email with server access details.

Prerequisites

For Windows:

• Download PuTTy
• Download WinSCP

For MacOS:

• Download Filezilla

Connecting to Your VPS

On Windows

Use PuTTy to connect to your VPS. Enter your Server IP in the "Host Name" field and click "Open."

Accept any security prompts on the first connection. Log in with your VPS credentials.

On MacOS

Connect using the Terminal:

ssh root@YOUR.IP.ADDRESS.HERE

Enter your server password when prompted.

Configuring the VPS (Optional)

Update Your VPS

Run the following command:

apt-get update && apt-get upgrade -y

Install NodeJS and PM2

PM2 makes it easy to keep the bot process alive while you are not logged into the server. It also provides advanced logging capabilities.

Install necessary packages and NodeJS:

sudo apt-get install -y ca-certificates curl gnupg
sudo mkdir -p /etc/apt/keyrings
curl -fsSL https://deb.nodesource.com/gpgkey/nodesource-repo.gpg.key | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] https://deb.nodesource.com/node_18.x nodistro main" | sudo tee /etc/apt/sources.list.d/nodesource.list
sudo apt-get install nodejs -y
apt-get install npm

In case you run into an error related to common.gypi, then the following steps could help:

sudo apt-get remove nodejs libnode-dev
sudo apt-get clean
curl -sL https://deb.nodesource.com/setup_20.x | sudo -E bash -
sudo apt-get install nodejs
sudo dpkg --configure -a
node -v

Install PM2, a process manager:

npm i -g pm2
pm2 install pm2-logrotate

Start Gunbot

Start Gunbot using PM2 (optional) or directly:

pm2 start gunthy-linux

To view Gunbot logs:

pm2 logs 1

Optional Steps

• Custom Naming: Give a custom name to your Gunbot instance:

  pm2 start gunthy-linux --name YourCustomNameHere

• Auto-restart on Reboot: Ensure Gunbot restarts automatically after a server reboot:

  pm2 startup
  pm2 save