Installation

Linux

Install the Portwarp CLI on Linux desktops, VPS instances, home servers, and ARM devices.

Quick install

The installer detects your operating system and CPU architecture, verifies the downloaded release, and installs pwrp in /usr/local/bin.

Shell

curl -fsSL https://portwarp.com/download/install.sh | bash

The installer needs curl, tar, and sha256sum. It may ask for sudo only when writing to /usr/local/bin.

Supported architectures

Architecture	Typical devices	Archive
x86-64	Most PCs, servers, and VPS instances	`linux-amd64`
ARM64	Raspberry Pi 4+, Graviton, modern ARM servers	`linux-arm64`
ARMv7	Raspberry Pi 3 and older 32-bit ARM devices	`linux-armv7`

Manual installation

If you cannot use the install script, download the matching archive and checksums.txt from CLI downloads. Then verify, extract, and install it:

Shell · example filenames

sha256sum -c checksums.txt --ignore-missing
tar -xzf pwrp-VERSION-linux-amd64.tar.gz
chmod +x pwrp
sudo mv pwrp /usr/local/bin/pwrp

Replace VERSION and amd64 with the values from the file you downloaded.

Verify and sign in

Shell

pwrp version
pwrp login
pwrp doctor

Start automatically

On Linux, pwrp service enable installs a systemd user service. Save the tunnel selection first:

Shell

pwrp connect --all --save --detach
pwrp service enable
pwrp service status

A systemd user service normally starts when that user logs in. If you need it to run before an interactive login, enable lingering for that user according to your Linux distribution's systemd documentation.

Update or remove

Use pwrp update for normal updates. To remove the CLI, disable startup, log out, and delete the binary:

Shell

pwrp service disable
pwrp logout
sudo rm /usr/local/bin/pwrp