FR-XrayR Manager

Complete setup guide for the FR-XrayR Manager WHMCS addon module — server management, inbounds, templates, and product integration.

Installing FR-XrayR Manager in WHMCS

Module Overview

FR-XrayR Manager is a comprehensive WHMCS addon that lets you manage XrayR proxy servers and FreeRADIUS authentication directly from your WHMCS admin panel. It automates server provisioning, user management, and subscription delivery for VPN/proxy services.

Server Dashboard

Monitor all your servers at a glance — see online status, connections, CPU & memory usage, ping, and version information. Add FreeRADIUS API servers and XrayR nodes with one-click installation.

FR-XrayR Manager Dashboard showing server overview with status, connections, and resource usage

Inbound Configuration

Configure proxy inbounds per server with support for VLESS, VMess, Trojan, and Shadowsocks protocols. Choose from presets like VLESS + REALITY or VLESS + TLS + WebSocket, with full control over network transport, security, and encryption settings.

Inbounds page showing configured VLESS inbounds with protocol, port, network, and security details

User Management

View all provisioned users with real-time status, connection details, assigned servers and inbounds, speed limits, and bandwidth usage. Click any user to see their detailed traffic history with interactive graphs.

Users page showing active users with status, connections, speed, and data usage

User traffic details modal with interactive traffic graph over time

Traffic Charts

Visualize traffic across your entire network with detailed graphs. See total traffic, upload/download breakdown, protocol distribution, and per-node traffic over time.

Charts page showing traffic graphs, protocol distribution, and per-node bandwidth

Audit & Security Logs

Full audit trail of all provisioning events (account creation, suspension, termination) and security monitoring with firewall statistics — blocked IPs, targeted ports, and active firewall rules.

Audit log showing provisioning events with timestamps

Security log showing blocked IPs, targeting ports, and firewall rules

Installation Guide

Follow the steps below to install and configure FR-XrayR Manager in your WHMCS installation.

Prerequisites

Step 1: Navigate to Addon Modules

In your WHMCS admin panel, go to System Settings. Type "addon" in the search box and click Addon Modules.

WHMCS System Settings - search for addon and click Addon Modules

Step 2: Activate FR-XrayR Manager

Find FR-XrayR Manager in the addon modules list and click the green Activate button to enable the module.

Addons list showing FR-XrayR Manager with Activate button

Step 3: Configure the Module

After activation, the module settings will expand. Fill in the required fields:

Click Save Changes when done.

FR-XrayR Manager module configuration

Important: The encryption key is used to encrypt all stored SSH passwords and API tokens. Keep it safe and do not change it after servers have been added, or you will lose access to stored credentials.

Step 4: Install FreeRADIUS on Your Server

After activation, the FR-XrayR Manager dashboard appears. Your FreeRADIUS server should already be listed. Click the three-dot menu (...) on the server row, then select Install FreeRADIUS.

Dashboard with server actions menu showing Install FreeRADIUS option

Step 5: Fix Passwordless Sudo (If Required)

If you see a "Failed" message, the web server user needs passwordless sudo access to run the install script. Copy the command shown in the error message and run it on your server via SSH:

echo 'www-data ALL=(root) NOPASSWD: /bin/bash /tmp/install_freeradius_server.sh *, /bin/bash /tmp/uninstall_freeradius.sh *' | sudo tee /etc/sudoers.d/freeradius-install

After running this command, go back and click Install FreeRADIUS again.

Install FreeRADIUS dialog showing Failed status with sudo command

Step 6: Edit FreeRADIUS Server Details

Click the three-dot menu (...) on your FreeRADIUS server row and select Edit. Fill in the required connection details:

The API URL will auto-populate based on the IP address. Click Save.

Edit Server dialog with connection fields highlighted

Step 7: Save Server Configuration

Verify all fields are filled in correctly, including the Country, IP Address, SSH Username, and SSH Password. The API URL and token fields will be pre-filled. Click Save to store the configuration.

Edit Server dialog with all fields completed and Save button highlighted

Tip: Use the Test Connection button to verify SSH connectivity before saving.

Step 8: Add an XrayR Node Server

Click the Add XrayR Server button on the dashboard. Fill in the server details:

Check Install XrayR after adding to automatically install XrayR on the server. If using HTTPS, select Let's Encrypt as the certificate mode, then enter your Domain and Email. Click Add XrayR Server.

Add XrayR Server dialog with all fields highlighted

Tip: Make sure your domain's DNS A record points to the server's IP before using Let's Encrypt, otherwise certificate generation will fail.

Step 9: Monitor XrayR Installation

The installation log will open automatically, showing real-time progress. Wait for the installation to complete. This typically takes 2–5 minutes depending on your server's speed.

XrayR Installation Log showing terminal output

Do not close this window until the installation finishes. If it fails, check the log output for errors and ensure your server meets the minimum requirements (Ubuntu 20.04+ or Debian 11+).

Step 10: Navigate to Inbounds

Once your XrayR server is installed, click the Inbounds tab. Select your XrayR server from the dropdown if not already selected. Click the Add Inbound button to create a new inbound configuration.

Inbounds tab with Add Inbound button highlighted

Step 11: Configure an Inbound

In the Add Inbound dialog, select a Preset to get started quickly. The recommended preset is VLESS + REALITY, which provides the best security and performance. The configuration fields and JSON preview will auto-populate. Click Add Inbound to save.

Add Inbound dialog with VLESS + REALITY preset

Tip: VLESS + REALITY is recommended because it doesn't require a domain or TLS certificate and provides excellent anti-detection capabilities.

Step 12: Navigate to Templates

Click the Templates tab. Templates group servers and inbounds into packages that can be assigned to WHMCS products. Click Add Template to create one.

Templates tab with Add Template button highlighted

Step 13: Create a Template

Fill in the template details:

Click Save to create the template.

Add Template dialog with name and server selection

Step 14: Verify Sync Status & Update Files

Click the Status tab to verify that your inbounds are synced with the FreeRADIUS API. You should see:

Click the Update Files button to deploy the subscription endpoint file to your WHMCS installation.

Status tab showing sync status and Update Files button

Go to Products/Services in WHMCS and edit the product you want to use with FR-XrayR. On the Module Settings tab:

Click Save Changes. New orders for this product will now automatically provision VPN accounts.

WHMCS Product Module Settings

Installation Complete! FR-XrayR Manager is now fully configured. New customer orders will automatically create VPN accounts with subscription links.