PeyGridLinux guide

Run PeyGrid on Linux

PeyGrid rents out the idle time of your graphics cards and pays you in USDT on the Polygon network for the graphics processing they contribute. On Linux it installs with one command and runs in the background as a system service: no window and no desktop needed, so it suits rigs and servers that nobody sits at.

The install commandFree. One account for all your machines.

Who it is for

  • GPU rigs with several graphics cards, including rigs on HiveOS.
  • Servers with NVIDIA or AMD graphics cards.
  • Linux desktops and laptops with an NVIDIA or AMD graphics card.
  • A machine without a usable graphics card works on its processor (CPU) only, and earns less.

On Windows or a Mac, follow the setup guide instead.

What you need

  • A 64-bit PC (x86_64) running Linux with systemd and glibc 2.28 or newer: Ubuntu 20.04 or newer, Debian 10 or newer, a current HiveOS, or another distribution of that age. ARM boards such as the Raspberry Pi are not supported.
  • Root access (sudo) and curl. On Ubuntu or Debian without curl: sudo apt install curl.
  • NVIDIA graphics cards: the NVIDIA driver; nvidia-smi must list your cards. The RTX 30 series or newer is recommended.
  • AMD graphics cards: the AMD driver with its OpenCL runtime (ROCm, or AMD's OpenCL package for your distribution); clinfo must list your cards.
  • HiveOS already comes with the NVIDIA and AMD drivers.
  • An internet connection. PeyGrid only makes outgoing connections: there is nothing to open on your router or firewall.
  • A wallet address on the Polygon network, starting with 0x, to withdraw your earnings. You can start without one and add it later.

Install

Open a terminal on the machine, or connect to it with SSH, and run:

curl -fsSL https://peygrid.com/download/linux | sudo bash

The command fetches the installer from PeyGrid and runs it as root. It takes a minute or two; at the end it shows how to link the machine to your account.

If a friend or a reseller invited you, add their username or wallet as the referral, with the quotes: curl -fsSL 'https://peygrid.com/download/linux?referral=NAME' | sudo bash (NAME replaced). A link from them to the PeyGrid website, or to this guide, shows the command with it filled in.

Options go after bash -s --, for example to use the graphics cards only:

curl -fsSL https://peygrid.com/download/linux | sudo bash -s -- --no-cpu
  • --no-cpu: the graphics cards only, never the processor.
  • --referral NAME: the referral, as in the link above.
  • --uninstall: remove PeyGrid (see Uninstall).

What the installer sets up

  • The system user peygrid (no password, no login), allowed to use the graphics cards (groups video and render).
  • PeyGrid's folder /var/lib/peygrid: the program, its settings and its logs.
  • The systemd service peygrid: it starts when the machine boots, starts again by itself if it ever stops, and runs at a low priority so the machine stays responsive.
  • The peygrid command for your account (next section).
  • Updates: PeyGrid downloads a new version itself, checks it and restarts on it.

Your account

The machine starts working right after the install, as a guest: it earns all the same, and what it has earned moves to your account when you sign up or sign in. To withdraw you need an account with a wallet.

sudo peygrid signup
Create a new account: your first machine with PeyGrid. It asks for a username and a password, and optionally a wallet and a referral.
sudo peygrid signin
You already use PeyGrid on another PC: sign in with the same username and password, and this machine earns for the same account.
sudo peygrid status
What the machine is doing and which account it works for.

Usernames and passwords follow the same rules as on Windows (see the setup guide). Several rigs: install PeyGrid on each and sign in with the same account; their earnings add up in one balance.

Logs

journalctl -u peygrid -f

shows what PeyGrid is doing, live. Press Ctrl+C to stop watching; PeyGrid keeps running. journalctl -u peygrid -n 200 prints the last 200 lines, for someone helping you.

Stop and start

sudo systemctl stop peygrid
sudo systemctl start peygrid
sudo systemctl restart peygrid
systemctl status peygrid

A stopped service starts again at the next boot. To keep it off across boots: sudo systemctl disable --now peygrid; sudo systemctl enable --now peygrid turns it back on.

Uninstall

curl -fsSL https://peygrid.com/download/linux | sudo bash -s -- --uninstall

This removes the service, the peygrid command, /var/lib/peygrid and the peygrid user. Your earnings stay with your account: install again later and sign in to continue.

HiveOS

  • It needs a HiveOS image based on Ubuntu 20.04 or newer (glibc 2.28+). Older images based on Ubuntu 18.04 are refused by the installer with a clear message: update the rig's image first.
  • Open the rig's shell (Hive Shell from the web dashboard, or SSH) and run the install command. On HiveOS you are root already; sudo does no harm.
  • It survives reboots: the service starts with the rig, as on any Linux.
  • Stop the rig's flight sheet while PeyGrid runs: two programs on the same cards share them and both run slower.
  • Flashing a new HiveOS image onto the rig's disk removes PeyGrid with everything else: run the install command again, then sudo peygrid signin.

Problems

  • No graphics card is used: nvidia-smi (NVIDIA) or clinfo (AMD) must list the cards. Install or update the driver, then sudo systemctl restart peygrid.
  • curl: (22) The requested URL returned error: 404: the Linux version is being updated on PeyGrid; try again in a few minutes.
  • sudo: command not found: as root, install it first (apt install sudo); the peygrid command uses it too.
  • The service keeps restarting: journalctl -u peygrid -n 100 shows why. A distribution older than Ubuntu 20.04 or Debian 10 is too old for PeyGrid.
  • PeyGrid unreachable: the machine needs outgoing HTTPS (port 443); PeyGrid keeps trying by itself.
  • Anything else: contact your reseller or the PeyGrid admin.