Skip to main content

Initial Setup

Once Pyxsoft Firewall (PXF) has been successfully installed, it starts in a safe, non-blocking mode to prevent accidental service disruption. Follow the steps below to complete your initial configuration.


1. Default State After Installation

After installation:

  • The firewall is disabled by default — no ports or IPs are blocked.
  • The pxf service is active and enabled to start automatically at boot.
  • All ports are temporarily open, and the system operates in a permissive policy (allow all incoming and outgoing traffic).

This ensures that your server remains fully accessible while you review and confirm the configuration.


2. Accessing the Web Interface

  1. Log in to WHM using your administrator credentials.
  2. In the left sidebar, navigate to Pyxsoft Firewall.

3. Initial Configuration Screen

You will be greeted by the main configuration dashboard, which lists all the essential ports required for cPanel and WHM to operate correctly.

PXF Initial Setup Screen

Description:
The initial screen displays a list of ports that PXF automatically detects and allows by default.

Default Allowed Ports

ServicePortsNotes
cPanel / WHM / Webmail / WebDAV2077, 2078, 2082, 2083, 2086, 2087, 2095, 2096Core web management ports
SSH(autodetected)The SSH port is automatically detected during installation
DNS53/tcp, 53/udpRequired for DNS resolution
Mail Services25, 465, 587, 110, 995, 143, 993SMTP, POP3, and IMAP
FTP21FTP control port
FTP Passive Range(autodetected)Detected automatically from Pure-FTPd or ProFTPD configuration

4. Enabling the Firewall

Once you have verified that all required ports are listed and correct, click Enable Firewall.

  • Pyxsoft Firewall will immediately close all ports not listed above.
  • Only the allowed ports will remain open.

This ensures your server is now protected according to your confirmed configuration.


5. Test Mode

When first enabled, the firewall automatically starts in TEST MODE.

  • This mode allows you to verify that all your services continue functioning correctly.
  • After 2–3 minutes, the firewall will automatically disable itself to prevent accidental lockout.

You can enable it multiple times while testing and fine-tuning your settings.


6. Final Activation

Once you have confirmed that all necessary services work properly:

  1. Re-enable the firewall.
  2. Disable TEST MODE from the interface.

From that moment on, Pyxsoft Firewall will remain permanently active, enforcing your configuration and securing your server.


tip

Always verify that your SSH port is listed before final activation to avoid losing remote access.