Getting Started

Welcome to Pyxsoft! Our web-security suite is made of two separate products, each installed on its own:

• Pyxsoft pxShield (WAF) — a server-side Web Application Firewall that sits in front of your web server and blocks attacks before they reach it. It runs on cPanel/WHM or on any Linux server running Apache, nginx or Caddy — with any control panel (DirectAdmin, ISPConfig, …) or none at all.
• Pyxsoft Web Malware Protection — real-time malware detection and quarantine for cPanel servers, scanning every account the moment files hit disk.

This guide walks you through installing and managing both.

Where you manage pxShield

The pxShield engine is identical everywhere — only the management UI differs:

• On cPanel/WHM — the interface is built right into WHM, and a per-account dashboard appears inside each cPanel account.
• On any other server — manage pxShield through CentralHost, our cloud console. Your first server is free.

Requirements

Pyxsoft pxShield (WAF)

• A Linux server (x86_64) running Apache, nginx or Caddy — RHEL family (7–10), Debian or Ubuntu
• cPanel/WHM is optional; any control panel, or none, works

Pyxsoft Web Malware Protection

• cPanel/WHM installed
• One of the following operating systems — versions 7, 8, 9 or 10:
  • AlmaLinux
  • CloudLinux
  • Rocky Linux
  • RHEL
  • CentOS

Automatic Installation

Pyxsoft Web Malware Protection and Pyxsoft pxShield (WAF) are separate products, each with its own installer. Install only the one you need (or both, one after the other) — they are no longer installed together.

Run in the server using SSH or through the WHM Terminal, as root:

Pyxsoft Web Malware Protection (real-time detection & quarantine):

curl -s https://www.pyxsoft.com/install-anti-malware | bash

Pyxsoft pxShield / WAF (server-side WAF in front of Apache, nginx or Caddy):

curl -s https://www.pyxsoft.com/install-pxshield | bash

Each installer detects your OS and control panel, adds the Pyxsoft repository, installs that product's components, and starts the associated services. You can run both installers on the same server if you want detection and prevention together.

Managing pxShield after install

On cPanel/WHM the interface appears in WHM automatically. On any other server, connect it to CentralHost to manage rules, domains and events from the cloud console — the first server is free.

Upgrading from a previous version

To upgrade to the latest version, re-run the installer for the product you have. The installer detects your existing installation and upgrades that product's components in place — your configuration and data are preserved.

1. Run the Upgrade Command: Use SSH or the WHM Terminal to execute the installer for the product you want to upgrade:

   # Web Malware Protection
   curl -s https://www.pyxsoft.com/install-anti-malware | bash
   
   # pxShield / WAF
   curl -s https://www.pyxsoft.com/install-pxshield | bash

   If you run both products, run both commands.

2. Verify the Upgrade: Once the command finishes, you can verify that the update was successful by checking the Pyxsoft section in WHM.

Note: This upgrade procedure is safe and recommended. You do not need to manually uninstall the previous version; running the installation script will handle the upgrade process seamlessly.

info

If you encounter any issues during the installation or upgrade process, please contact us at info@pyxsoft.com and our support team will be happy to assist you.

Manual Installation

Web Malware Protection requires cPanel/WHM and installs on RHEL/CentOS/AlmaLinux/Rocky/CloudLinux 7–10. pxShield is panel-agnostic and additionally supports Debian and Ubuntu (via apt).

If you prefer to install Pyxsoft manually, follow these steps.

RHEL family (yum / dnf)

1. Remove any previous installation of Pyxsoft:

# Stop and disable old services if they exist
systemctl stop pyxsoft.service pxscand.service

# Remove old packages if they exist
yum -y remove pyxsoft-cpanel pxscand pyxsoftui
yum -y clean all 

# Remove old repository files if they exist
rm /etc/yum.repos.d/pyxsoft*

# Remove old files
rm -fR /opt/pyxsoft
rm -fR /opt/pxscand

# Remove old unit files
rm -f /etc/systemd/system/pyxsoft.service
rm -f /etc/systemd/system/pxscand.service

# Remove old logs
rm -fR /var/log/pyxsoft 

2. Add the new Pyxsoft repository:

Create the file /etc/yum.repos.d/pyxsoft.repo with the following content:

[pyxsoft-x86_64]
name=Pyxsoft (x86_64)
baseurl=https://repo.pyxsoft.com/pyxsoft/any/any/x86_64/
enabled=1
gpgcheck=1
gpgkey=https://repo.pyxsoft.com/public-keys/gpg.key
metadata_expire=300

[pyxsoft-noarch]
name=Pyxsoft (noarch)
baseurl=https://repo.pyxsoft.com/pyxsoft/any/any/noarch/
enabled=1
gpgcheck=1
gpgkey=https://repo.pyxsoft.com/public-keys/gpg.key
metadata_expire=300

3. Update yum cache:

yum -y clean all
yum -y makecache

4. Install the product(s) you need:

# Pyxsoft Web Malware Protection (cPanel)
yum -y install pyxsoft-service pyxsoft-am-whm

# Pyxsoft pxShield / WAF — cPanel (meta-package with the WHM UI)
yum -y install pxshield-cpanel

# Pyxsoft pxShield / WAF — any other server (engine only; manage via CentralHost)
yum -y install pxshield

Debian / Ubuntu (apt)

Only pxShield ships for Debian-family systems (Web Malware Protection requires cPanel, which is RHEL-only).

1. Add the Pyxsoft repository:

curl -fsSL -o /tmp/pyxsoft-repo.deb https://www.pyxsoft.com/extra/repo-latest.deb
dpkg -i /tmp/pyxsoft-repo.deb || apt-get -y -f install
apt-get update

2. Install pxShield:

# Engine only — manage via CentralHost (https://www.centralhost.sh)
apt-get -y install pxshield

Removing Pyxsoft

Remove only the product you want to uninstall:

# Pyxsoft Web Malware Protection
yum remove pyxsoft-am-whm

# Pyxsoft pxShield / WAF — cPanel
yum remove pxshield-cpanel

# Pyxsoft pxShield / WAF — any other server
yum remove pxshield

On Debian / Ubuntu:

apt-get remove pxshield

Frequently Asked Questions (Installation)

No. Older versions (prior to 4.0) required ports 2930 and 2931. Starting with version 4.0, no additional open ports are needed.