Installation and configuration guide

• Setup (install/update)
• License Activation
• PUQVPNCP installation and configuration
• Add server (PUQVPNCP) in WISECP
• Service configuration

Setup (install/update)

WireGuard VPN module WISECP 

Order now | Download | FAQ

To install and update a module, you must perform one and the same action.

 

1. Download the latest version of the module.

wget http://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/PUQ_WISECP-WireGuard-VPN-latest.zip

All versions are available: https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/

 

2. Unzip the archive with the module.

unzip PUQ_WISECP-WireGuard-VPN-latest.zip

 

3. Copy and Replace "puqWireGuardVPN" from "PUQ_WISECP-WireGuard-VPN" to "WISECP_WEB_DIR/coremio/modules/Product/"

License Activation

WireGuard VPN module WISECP 

Order now | Download | FAQ

1. Log in to the administrative area of your WISECP.

2. Go to module configuration.

Services -> Service Management -> Module Settings -> Other -> All Modules -> PUQ WireGuard VPN

 

3. On the open page, enter the purchased license key for this product and click the 'Check and Save' button to validate the key and save it.

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

 

PUQVPNCP installation and configuration

WireGuard VPN module WISECP 

Order now | Download | FAQ

Official documentation:

PUQVPNCP Documentation
PUQVPNCP Download
PUQVPNCP Order now

1. Install the required packages

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/

3. Install the puqvpncp package

wget https://download.puqcloud.com/cp/puqvpncp/puqvpncp_XXXX_amd64.deb
dpkg -i puqvpncp_XXXX_amd64.deb

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

http://SERVER_IP:8098
Username: admin
Password: admin

 

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.

nano /etc/puqvpncp/puqvpncp.conf 

LetsEncrypSSL=yes
Domain=XXXXXX.XXX

Restart the PUQVPNCP service

service puqvpncp restart

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.

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.

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.

 

6. License configuration is available in the menu item Settings->License

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

 

7.Creation of access API

To manage API Access Hashs, go to the section Settings->API

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

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.

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.

 

8. Creation of access API

Add new WireGuard is available in the menu item VPN servers->WireGuard->Click Create

 

Enter or edit the parameters of the new server/interface and click the ADD button

 

 

Add server (PUQVPNCP) in WISECP

WireGuard VPN module WISECP 

Order now | Download | FAQ

1. Log in to the administrative area of your WISECP.

2. Go to module configuration.

Services -> Service Management -> Module Settings -> Other -> All Modules -> PUQ WireGuard VPN

 

3. In the opened page, click the 'Add Server' button.

 

4. On the opened page, enter all the necessary information:

• Name: Displayed name of the server.
• Maximum Number of Accounts: The number of services that can be on this server.
• Server Group: Optionally, choose the server group.
• IP Address or Domain: The address of the PUQVPNCP server you are connecting to.
• Access Hash: API key that you created in the previous step on the PUQVPNCP server.
• Check the SSL box if you want to use SSL-encrypted connection. If necessary, specify the port and perform a connection test.
  

  

 

 

 

 

 

 

 

 

 

 

 

 

 

 

Service configuration

WireGuard VPN module WISECP 

Order now | Download | FAQ

If you do not have a Service Group where you want to place the new service, you need to create a new Service Group

1. Log in to the administrative area of your WISECP.

2. Create New Service Group

Go to

Services -> Service Management -> Add Group

Enter all the necessary data and click the 'Create Group' button.

3. Adding a New Service

Go to

Services -> our service group where you need to add the new service.

In the opened window, click the 'Create New Service' button.

On the opened page, enter all the necessary details for your new service and navigate to the 'Core' tab.

Select the 'PUQ WireGuard VPN' module from the drop-down list of modules.

4. Fill in the configuration options according to your preferences.

• Server Group is the group of servers from which a server will be chosen for provisioning the service
• WireGuard Server is the name of the WireGuard server that was created in PUQVPNCP

Attention:
The WireGuard Server field is updated only after saving or adding the service.
You will need to revisit this section to select the WireGuard Server and save the service.
Additionally, the WireGuard Server must be created on all servers within the group.

• Bandwidth Download and Bandwidth Upload represent the connection speed that will be restricted by these parameters, in megabits per second, respectively.
• Username Prefix will be added at the beginning of the username during user creation and is used for uniqueness
• Username Suffix will be added at the end of the username during user creation and is also used for uniqueness

• Link to Instruction Provide the link to the instruction for the service, and it will be displayed in the client area as a separate button

• Link to VPN Clients Provide the link to the page for downloading VPN clients for the service, and it will be displayed in the client area as a separate button

• Automatic Setup Please activate for automatic installation of the order. Otherwise, administrator approval is required.