Installation Guide
This guide will help you install PG on various Linux distributions.
Follow the steps for your specific distro.
Supported Linux Distributions
| Distro | Package Manager | Support Level | Notes |
|---|---|---|---|
| Ubuntu/Debian | apt | ✅ Full | Recommended for beginners |
| Fedora | dnf | ✅ Full | Works out-of-the-box |
| Arch Linux | pacman | ✅ Full | Latest packages, rolling release |
| CentOS / RHEL | yum | ⚠️ Partial | Requires enabling NodeSource repo |
| Others (Mint, Pop!_OS, etc.) | Depends | ⚠️ Community | Should work with Ubuntu/Debian steps |
Prerequisites
Before installing, make sure you have:
- Node.js v18+
- npm or yarn
- git
- A Linux user account with sudo access
Ubuntu / Debian (apt)
# Update packages
sudo apt update && sudo apt upgrade -y
# Install Node.js (LTS)
curl -fsSL https://deb.nodesource.com/setup_18.x | sudo -E bash -
sudo apt install -y nodejs git
Verify versions
node -v
npm -v
Clone PG
git clone https://github.com/pg-cv/pg.git
cd pg
Install dependencies
npm install
Start PG
npm run start
Fedora (dnf)
Update system
sudo dnf upgrade -y
Enable Node.js
sudo dnf module install nodejs:18 -y
sudo dnf install git -y
Verify versions
node -v
npm -v
Clone PG
git clone https://github.com/pg-cv/pg.git
cd pg
Install dependencies
npm install
Start PG
npm run start
Arch Linux (pacman)
Update system
sudo pacman -Syu
Install Node.js + Git
sudo pacman -S nodejs npm git --noconfirm
Verify versions
node -v
npm -v
Clone PG
git clone https://github.com/pg-cv/pg.git
cd pg
Install dependencies
npm install
Start PG
npm run start
CentOS / RHEL
Enable NodeSource repo
curl -fsSL https://rpm.nodesource.com/setup_18.x | sudo bash -
Install Node.js + Git
sudo yum install -y nodejs git
Verify versions
node -v
npm -v
Clone PG
git clone https://github.com/pg-cv/pg.git
cd pg
Install dependencies
npm install
Start PG
npm run start
Misc Tasks
Configure PG via the .env file.
Run PG in the background using pm2:
npm install -g pm2
pm2 start npm --name "pg" -- run start
pm2 save
pm2 startup
You've successfully installed PG on your Linux system!