# WireGuard Business-VPN WHMCS module

# Description

### WireGuard Business-VPN module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-wireguard-business-vpn.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/) | [FAQ](https://faq.puqcloud.com/)

#### The WireGuard Business VPN module provides the ability to sell the Virtual Private Network service to business customers.

The module is designed as a professional solution for companies and corporations, which enables remote access to company resources from anywhere in the world in a safe and monitored manner. The biggest difference from common VPN solutions such as NordVPN, EasyVPN etc. is the professional nature of the service.

##### Attention.  
The module require the PUQVPNCP control panel with active license.  
  
[PUQVPNCP Documentation](https://doc.puq.info/books/puqvpncp/page/description)  
[PUQVPNCP Download](https://download.puqcloud.com/cp/puqvpncp/)  
[PUQVPNCP Order now](https://panel.puqcloud.com/index.php?rp=/store/puqvpn)

#####  

##### What makes Business VPN different from regular, widely offered VPNs

The end customer of the service receives such opportunities as:

- Dedicated permanent IP address
- Full management of VPN accounts to the end buyer: Create, modify, delete and block VPN accounts

Thanks to our solution, the client does not have to delegate the company's resources to carry out this activity, but focus on the practical side of using it, thanks to which he saves money.

This model of operation allows IT departments in companies to configure in detail and securely internal Firewall, passing specific ports, detailed traffic monitoring, or to keep through internal IDS *which is not possible when using commonly offered solutions.*  
Such a VPN becomes an integral part of the company's IT infrastructure and is ideally suited to the conditions of a given client.

#### Who and why needs such a service that this module provides.

The service offers to the end customer a fully fledged private network.

1. The service combines all nodes that are connected via VPN into one private network. This allows you to communicate with each other from different physical locations. An example of use is, the remote work of the company's staff, having private remote access to each other. Also, due to the fact that each connected VPN user will be presented on the Internet with the public address of the service, it is possible to configure access to the company's servers only from the IP address of the service. Thus restrict access only to everyone except users of the service.
2. If your employees need to have access to some sites on the Internet and be represented by a public address of a certain geographic location, then this service allows you to implement it. The public address of the service is not changed during the entire time of using the service.
3. Ability to connect network devices, such as measuring instruments, to the same network, creating remote access to network equipment.

### Module Functions:

- Auto create and deploy VPN account/accounts
- Suspend/Unsuspend/Terminate/Change Package
- Require active license for **[PUQVPNCP](https://doc.puq.info/books/puqvpncp/page/description)** API
- Possibility to set Bandwidth speed limits
- Module supports multilingualism **(Arabic, Azerbaijani, Catalan, Chinese, Croatian, Czech, Danish, Dutch, English, Estonian, Farsi, French, German, Hebrew, Hungarian, Italian, Macedonian, Norwegian, Polish, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian)**
- Account limit per package
- Bandwidth Limit per account
- Link to instructions for setting up the service in the client area
- Port forwarding

### Functions of the client area:

- Creating VPN Accounts
- Deleting a VPN account
- Blocking VPN account

- - - - - -

<p class="callout warning">WHMCS minimal version: 8 +</p>

<p class="callout warning">[PUQVPNCP](https://doc.puq.info/books/puqvpncp/page/description): 1.6 +</p>

[![image-1678734264774.png](https://doc.puq.info/uploads/images/gallery/2023-03/scaled-1680-/image-1678734264774.png)](https://doc.puq.info/uploads/images/gallery/2023-03/image-1678734264774.png)

[![image-1678734272421.png](https://doc.puq.info/uploads/images/gallery/2023-03/scaled-1680-/image-1678734272421.png)](https://doc.puq.info/uploads/images/gallery/2023-03/image-1678734272421.png)

[![image-1678734279240.png](https://doc.puq.info/uploads/images/gallery/2023-03/scaled-1680-/image-1678734279240.png)](https://doc.puq.info/uploads/images/gallery/2023-03/image-1678734279240.png)

[![image-1678734288274.png](https://doc.puq.info/uploads/images/gallery/2023-03/scaled-1680-/image-1678734288274.png)](https://doc.puq.info/uploads/images/gallery/2023-03/image-1678734288274.png)# Changelog

### WireGuard Business-VPN module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-wireguard-business-vpn.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/) | [FAQ](https://faq.puqcloud.com/)

##### v2.0 Released 23-09-2024

<p class="callout info">**Module is coded ionCube v13**</p>

Supported php version:

- php 7.4 WHMCS 8.11.0 -
- php 8.1 WHMCS 8.11.0 +
- php 8.2 WHMCS 8.11.0 +

- - - - - -

##### v1.5 Released 07-04-2024

1. <span class="version-number">Added "endpoint configuration option" to service configuration</span>

- - - - - -

##### v1.4.5 Released 11-10-2023

1. <span class="version-number">Supported WHMCS <span class="server-summary-list-value">v8.8.0</span>  
    </span>
2. Translations added/updated (**Arabic, Azerbaijani, Catalan, Chinese, Croatian, Czech, Danish, Dutch, English, Estonian, Farsi, French, German, Hebrew, Hungarian, Italian, Macedonian, Norwegian, Polish, Romanian, Russian, Spanish, Swedish, Turkish, Ukrainian**)

- - - - - -

##### v1.4 Released 05-06-2023

1. Added the ability to change the MTU of the WireGuard interface
2. Added the ability to set AllowedIPs on the WireGuard interface

Requires PUQVPNCP 1.6.1+

- - - - - -

##### v1.3.1 Released 14-03-2023

1. Fixed bug with urls in templates. The bug occurred in the case when WHMCS is not installed in the root folder of the site.

- - - - - -

##### v1.3 Released 02-03-2023

1. Added port forwarding functionality
2. Design changes, icons added

- - - - - -

##### v1.2.1 Released 20-02-2023

1. Support for php 7.4 has been restored
2. Fixed bugs in templates
3. Added login button
4. Adding icons in templates

- - - - - -

##### v1.2 Released 07-01-2023

1. Support WHMCS V8.6
2. Support IonCube PHP Loader v12
3. Support for PHP 8.1
4. Support IKEv2

- - - - - -

##### v1.0 Released 25-11-2022

First version# Installation and configuration guide



# WHMCS setup(install/update)

### WireGuard Business-VPN module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-wireguard-business-vpn.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/) | [FAQ](https://faq.puqcloud.com/)

<p class="callout info">**Module is coded ionCube v13**</p>

Supported php version:

- php 7.4 WHMCS 8.11.0 -
- php 8.1 WHMCS 8.11.0 +
- php 8.2 WHMCS 8.11.0 +

<p class="callout info">To install and update a module, you must perform one and the same action.</p>

##### 1. Download the latest version of the module.

PHP 8.2

```Powershell
wget http://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/php82/PUQ_WHMCS-WireGuard-Business-VPN-latest.zip
```

PHP 8.1

```Powershell
wget http://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/php81/PUQ_WHMCS-WireGuard-Business-VPN-latest.zip
```

PHP 7.4

```Powershell
wget http://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/php74/PUQ_WHMCS-WireGuard-Business-VPN-latest.zip
```

<p class="callout info">All versions are available: [https://download.puqcloud.com/WHMCS/servers/PUQ\_WHMCS-WireGuard-Business-VPN/](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/)</p>

##### 2. Unzip the archive with the module.

```Powershell
unzip PUQ_WHMCS-WireGuard-Business-VPN-latest.zip
```

##### 3. Copy and Replace "puqWireGuardBusinessVPN" to "WHMCS\_WEB\_DIR/modules/servers/"

<div id="bkmrk-"><div></div></div>

# PUQVPNCP installation and configuration

### WireGuard Business-VPN module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-wireguard-business-vpn.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/) | [FAQ](https://faq.puqcloud.com/)

##### Official documentation:  
  
[PUQVPNCP Documentation](https://doc.puq.info/books/puqvpncp/page/description)  
[PUQVPNCP Download](https://download.puqcloud.com/cp/puqvpncp/)  
[PUQVPNCP Order now](https://panel.puqcloud.com/index.php?rp=/store/puqvpn)

#### **1. Install the required packages**

```shell
apt-get update
apt-get install wireguard wireguard-dkms wireguard-tools -y
apt-get install iproute2 iptables -y
apt-get install bind9 -y
```

#### 2. **Download the latest version of the package**

[https://download.puqcloud.com/cp/puqvpncp/](https://download.puqcloud.com/cp/puqvpncp/)

#### 3. Install the puqvpncp package

```shell
wget https://download.puqcloud.com/cp/puqvpncp/puqvpncp_1.6.1_amd64.deb
dpkg -i puqvpncp_1.6.1_amd64.deb
```

#### 4. After installation, connect to your server via a web browser.

http://SERVER\_IP:8098  
Username: admin  
Password: admin

[![image-1669217804065.png](https://doc.puq.info/uploads/images/gallery/2022-11/scaled-1680-/image-1669217804065.png)](https://doc.puq.info/uploads/images/gallery/2022-11/image-1669217804065.png)

[![image-1668690609770.png](https://doc.puq.info/uploads/images/gallery/2022-11/scaled-1680-/image-1668690609770.png)](https://doc.puq.info/uploads/images/gallery/2022-11/image-1668690609770.png)

#### **5. Enable SSL Let’s Encrypt** 

**Requirements**

- The active domain name that resolves the server's IP address
- Port 80 and 443 are always open, and not busy with another process

**In order for the system to start the procedure for obtaining an SSL certificate from Let's Encrypt, it is necessary.**

**In the configuration file, enable the use of SSL and enter the domain name.**

```shell
nano /etc/puqvpncp/puqvpncp.conf 
```

```shell
LetsEncrypSSL=yes
Domain=XXXXXX.XXX
```

Restart the **PUQVPNCP** service

```shell
service puqvpncp restart
```

<p class="callout info">After these steps, the first time you connect to the server via the https protocol, the system will request an SSL certificate and automatically renew it if necessary.</p>

<p class="callout warning">ATTENTION. After activating SSL, the system will only work in the https protocol on port 443.   
A redirect is also set from port 80 to port 443.</p>

<p class="callout warning">To connect to the server via the https protocol, use only the domain that was set in the configuration file.   
Otherwise, you will get an error that SSL is not working correctly.</p>

#### 6. License configuration is available in the menu item **Settings-&gt;License**

[![image-1668763551186.png](https://doc.puq.info/uploads/images/gallery/2022-11/scaled-1680-/image-1668763551186.png)](https://doc.puq.info/uploads/images/gallery/2022-11/image-1668763551186.png)

By default, the system limit is 50 users and the API is disabled.

In order to activate the license key, the key must be entered in the "License Key" field and click on the "Save" button

[![image-1668764171867.png](https://doc.puq.info/uploads/images/gallery/2022-11/scaled-1680-/image-1668764171867.png)](https://doc.puq.info/uploads/images/gallery/2022-11/image-1668764171867.png)

#### **7.Creation of access API**

To manage API Access Hashs, go to the section Settings-&gt;API

[![image-1668764483617.png](https://doc.puq.info/uploads/images/gallery/2022-11/scaled-1680-/image-1668764483617.png)](https://doc.puq.info/uploads/images/gallery/2022-11/image-1668764483617.png)

**Enter the name and IP address of the WHMCS server and click the ADD button**

<p class="callout warning">**Attention.   
The generated Access hash will only be shown once. Copy it, it will be needed during configuration of the product server in the WHMCS system.**</p>

<p class="callout info">Accept the fact that once the Access Hashs API is created, it will only be shown once.  
Each API Access Hash only works from a specific IP address.</p>

# Add server (PUQVPNCP) in WHMCS

### WireGuard Business-VPN module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-wireguard-business-vpn.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/) | [FAQ](https://faq.puqcloud.com/)

##### Add a new server to the system WHMCS.

Login to Your WHMCS panel and create new server in WHMCS (*System Settings-&gt;Products/Services-&gt;Servers*)

[![image-1663142713076.png](https://doc.puq.info/uploads/images/gallery/2022-09/scaled-1680-/image-1663142713076.png)](https://doc.puq.info/uploads/images/gallery/2022-09/image-1663142713076.png)

```
System Settings->Servers->Add New Server
```

- Enter the correct **Name** and **Hostname**

**Name is just for Your convenience and You can put there anything You like ie: *Mygreat PUQVPNCP routr***

<p class="callout info">**You can choose whatever hostname You want. Valid entries look similar to: vpn.mydomain.com, ourgreatvpn.mydomain.net. You can also dedicate whole domain ie: myVPNservices.com if You like. The important thing is to resolve the choosen IP address of the [PUQVPNCP](https://doc.puq.info/books/puqvpncp/page/description) in DNS server for Your domain.** </p>

- In the **"Assigned IP Addresses field"**, enter a list of IP addresses that will be issued to users.

[![image-1669286799237.png](https://doc.puq.info/uploads/images/gallery/2022-11/scaled-1680-/image-1669286799237.png)](https://doc.puq.info/uploads/images/gallery/2022-11/image-1669286799237.png)

#####  

##### Enter the correct data in the Access Hash field  
  


- In the **Server Details** section, select the "**PUQ WireGuard Business-VPN**" module and enter the correct API Access Hash.
- To check, click the **"Test connection"** button

[![image-1669287101265.png](https://doc.puq.info/uploads/images/gallery/2022-11/scaled-1680-/image-1669287101265.png)](https://doc.puq.info/uploads/images/gallery/2022-11/image-1669287101265.png)

# Product Configuration

### WireGuard Business-VPN module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-wireguard-business-vpn.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/) | [FAQ](https://faq.puqcloud.com/)

##### Add new product to WHMCS

```
System Settings->Products/Services->Create a New Product
```

In the **Module settings** section, select the **"PUQ WireGuard Business-VPN"** module

[![image-1673191608638.png](https://doc.puq.info/uploads/images/gallery/2023-01/scaled-1680-/image-1673191608638.png)](https://doc.puq.info/uploads/images/gallery/2023-01/image-1673191608638.png)

- **License key:** A pre-purchased license key for the **"PUQ WireGuard Business-VPN"** module. For the module to work correctly, the key must be active

##### WireGuard configuration 

- **Public IP for all services -** If you want to assign one public IP address to all services (IP must be configured on the **[PUQVPNCP](https://doc.puq.info/books/puqvpncp/page/description)** server)
- **Public IP -** If you want to assign one public IP address to all services (IP must be configured on the **[PUQVPNCP](https://doc.puq.info/books/puqvpncp/page/description)** server)
- **Allow internal traffic-** If you want to enable traffic exchange between VPN clients <span style="background-color: #ffff99;">**(package change)**</span>
- **DNS1, DNS2 -** DNS servers if they differ from the configuration in the **[PUQVPNCP](https://doc.puq.info/books/puqvpncp/page/description)** panel <span style="background-color: #ffff99;">**(package change)**</span>

##### VPN users settings

- **Number of VPN users -** Number of vpn accounts per service <span style="background-color: #ffff99;">**(package change)**</span>
- **Bandwidth Download** - Bandwidth Download of VPN accounts <span style="background-color: #ffff99;">**(package change)**</span>
- **Bandwidth Upload-** BandwidthUpload of VPN accounts <span style="background-color: #ffff99;">**(package change)**</span>
- **Link to instruction-** If you have prepared instructions for your customers on how to use the service, then a link to the instructions is provided here (If filled, it will be shown in the client area)
- **Link to VPN clients-** Link to download the VPN client. For example [https://www.wireguard.com/install/](https://www.wireguard.com/install/) (If filled, it will be shown in the client area)
- **Persistent Keepalive-** sets the Keepalive parameter in the WireGuard server client configuration <span style="background-color: #ffff99;">**(package change)**</span>
- **Enable IKEv2-** Enable IKEv2 protocol support <span style="background-color: #ffff99;">**(package change)**</span>

# Client Area



# Home screen

### WireGuard Business-VPN module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-wireguard-business-vpn.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/) | [FAQ](https://faq.puqcloud.com/)

##### Basic information on client panel page

**Dedicated IP:** The public IP address that is reserved for the service and through which all users of the VPN service will be represented on the Internet.  
  
**Private internal network:** Private subnet whose IP addresses are available to the client to create VPN accounts. When adding a new VPN account, it will be assigned an IP address from this internal pool of addresses.  
  
**VPN Protocols:** VPN protocols that are available  
  
**Number of VPN accounts:** Number of used and available VPN client accounts from the pool available based on the defined package.  
  
**Bandwidtht download/upload:** The bandwidth rate that will be available on each VPN client account

Links to **instructions** and a link to **download the VPN client** (these links must be set when configuring the product)

##### Function buttons for service management.

- **Add VPN account:** To create a new VPN account

##### List of VPN accounts with technical/dynamic data and also buttons **Management**

[![image-1678734385019.png](https://doc.puq.info/uploads/images/gallery/2023-03/scaled-1680-/image-1678734385019.png)](https://doc.puq.info/uploads/images/gallery/2023-03/image-1678734385019.png)

# Add VPN account

### WireGuard Business-VPN module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-wireguard-business-vpn.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/) | [FAQ](https://faq.puqcloud.com/)

##### This is how the page for adding a new VPN account looks like.

<p class="callout info">Each VPN account has a unique client ID, the ID is generated according to the scheme &lt;user\_id&gt;-&lt;service\_id&gt;-Manually entered value. &lt;user\_id&gt;-&lt;service\_id&gt; are generated automatically by module. You can modify manually the last part.</p>

[![image-1678734403522.png](https://doc.puq.info/uploads/images/gallery/2023-03/scaled-1680-/image-1678734403522.png)](https://doc.puq.info/uploads/images/gallery/2023-03/image-1678734403522.png)

To create a new account, the client must enter the following.

Username, Select an available IP address from the dropdown list. Then click the **Add VPN account** button.

# Management VPN account

### WireGuard Business-VPN module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-wireguard-business-vpn.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/) | [FAQ](https://faq.puqcloud.com/)

To manage/change your VPN account, click on the "Management" button on the selected account.

[![image-1673191194161.png](https://doc.puq.info/uploads/images/gallery/2023-01/scaled-1680-/image-1673191194161.png)](https://doc.puq.info/uploads/images/gallery/2023-01/image-1673191194161.png)

On the account management page you have the option.

- Change IP address
- Change password for IKEv2 protocol
- Deactivate account
- Delete account
- Download the configuration as a text file or as a QR code WireGuard protocol
- Download CA certificate IKEv2 protocol
- Download configuration profile for mobile devices IKEv2 protocol
- Generate a one-time link with connection parameters. For example, to transfer the connection settings to the end user

[![image-1678870158731.png](https://doc.puq.info/uploads/images/gallery/2023-03/scaled-1680-/image-1678870158731.png)](https://doc.puq.info/uploads/images/gallery/2023-03/image-1678870158731.png)

# Port forwarding

### WireGuard Business-VPN module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-wireguard-business-vpn.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/) | [FAQ](https://faq.puqcloud.com/)

To manage port forwarding, click the Port forwarding button.  
In the page that opens, it is possible to add or delete rules to port forwarding.

[![image-1678734571666.png](https://doc.puq.info/uploads/images/gallery/2023-03/scaled-1680-/image-1678734571666.png)](https://doc.puq.info/uploads/images/gallery/2023-03/image-1678734571666.png)

[![image-1678734446777.png](https://doc.puq.info/uploads/images/gallery/2023-03/scaled-1680-/image-1678734446777.png)](https://doc.puq.info/uploads/images/gallery/2023-03/image-1678734446777.png)

# Admin Area



# Product Home Screen

### WireGuard Business-VPN module **[WHMCS](https://puqcloud.com/link.php?id=77)**

#####  [Order now](https://puqcloud.com/whmcs-module-wireguard-business-vpn.php) | [Download](https://download.puqcloud.com/WHMCS/servers/PUQ_WHMCS-WireGuard-Business-VPN/) | [FAQ](https://faq.puqcloud.com/)

##### The main screen of the product contains the following items.

- WireGuard interface configuration information
- Firewall Nat Rules
- Firewall Filter Rules
- Traffic Control Rules
- List of VPN client accounts

[![image-1669291106642.png](https://doc.puq.info/uploads/images/gallery/2022-11/scaled-1680-/image-1669291106642.png)](https://doc.puq.info/uploads/images/gallery/2022-11/image-1669291106642.png)