Install

Before you start

• A Linux VPS you can log in to as root. PSM installs system services, certificates and firewall rules, so it needs root.
• Architecture: x86_64 or arm64.
• System: Debian, Ubuntu, Alpine or the Red Hat family (Rocky Linux, AlmaLinux, …). Versions and test coverage: Supported systems.
• Only bash and curl (or wget) need to be there already; everything else is installed the first time it is needed.

Install

As root, run one of these:

# with curl (recommended)
bash <(curl -fsSL https://psm.jinqians.com)

# with wget, if curl is missing
bash <(wget -qO- https://psm.jinqians.com)

The installer asks for the interface language, installs what PSM needs and registers the psm command. Then run:

psm

to open the menu, and continue with the quick start.

Alpine

A fresh Alpine has no bash; use this line instead (it installs bash with apk first):

wget -qO- https://psm.jinqians.com | sh

Manual install

git clone https://github.com/jinqians/proxy-stack.git /opt/psm
bash /opt/psm/install.sh

Update

Run the install command again, or choose "Update PSM" in the menu. Local edits to PSM's own files are saved as a patch file first, not thrown away.

Uninstall

bash /opt/psm/uninstall.sh

The uninstaller removes the commands, services and scheduled jobs PSM created. Components other things may share, such as Nginx, certificates and Docker apps, are removed only after asking you one by one.