Skip to main content

Installing Gunbot on Linux


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 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:


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:

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


For Windows:

For MacOS:

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."

PuTTy Connection

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

On MacOS

Connect using the Terminal:


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 | sudo gpg --dearmor -o /etc/apt/keyrings/nodesource.gpg
echo "deb [signed-by=/etc/apt/keyrings/nodesource.gpg] 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 | 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

PM2 Installation

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