# WireGuard VPN WISECP module
# Description
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
#### The WireGuard VPN module provides the ability to sell the Virtual Private Network service to customers.
##### 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)
**Requirements**
WISECP: v3.1.5+, php: v8.x, Ioncube: V12+
PUQVPNCP: v1.8+
##### Supports protocols:
- WireGuard
- IKEv2
##### Module Functions:
- Auto create and deploy VPN account/accounts
- Suspend/Unsuspend/Delete/Change Package
- Module require active **[PUQVPNCP](https://doc.puq.info/books/puqvpncp/page/description)** API (need separte license)
- Possibility to set Bandwidth speed limits
- Module supports multilingualism (**Arabic, Bosnian, Czech, German, Greek, English, Spanish, Persian, French, Hungarian, Indonesian, Italian, Georgian, Latvian, Dutch, Polish, Portuguese, Romanian, Ukrainian**)
- Link to instructions for setting up the service in the client area.
- Mechanism for working with servers and server groups
##### Available options in the admin panel:
- Create users
- Suspend users
- Unsuspend users
- Deleteusers
- Change Package
- VPN connection status
##### Available options in the client panel:
- Links in the form of buttons to the instruction and VPN clients
- General information about the service
- Password change option (for IKEv2)
- One-time link generation button for transmitting authorization data
- Option to download WireGuard configuration as a file
- QR code for WireGuard configuration
- Server certificate download button (for IKEv2)
- Download button for the profile for the strongSwan mobile application (for IKEv2)
- VPN connection status
##### Screenshot of the client area
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700430344429.png)
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700430111703.png)
##### Screenshot of the Admin area
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700430655794.png)
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700430835898.png)
# Changelog
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
##### v1.1 Released 15-02-2024
\- Fixed a bug with some cases where it was not possible to delete the server
\- Improved security
- - - - - -
##### v1.0 Released 06-12-2023
First version
# Installation and configuration guide
# Setup (install/update)
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
To install and update a module, you must perform one and the same action.
#####
##### 1. Download the latest version of the module.
```Powershell
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/](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/)
#####
##### 2. Unzip the archive with the module.
```Powershell
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](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
##### 1. Log in to the administrative area of your **[WISECP](https://puqcloud.com/link.php?id=78)**.
#####
2. Go to module configuration.
```
Services -> Service Management -> Module Settings -> Other -> All Modules -> PUQ WireGuard VPN
```
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700485721333.png)
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700485726951.png)
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700485737918.png)
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700485743386.png)
##### 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.
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700486620519.png)
#####
# PUQVPNCP installation and configuration
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-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_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
[](https://doc.puq.info/uploads/images/gallery/2022-11/image-1669217804065.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
```
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**
[](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
[](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->API
[](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**
**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**
[](https://doc.puq.info/uploads/images/gallery/2022-11/image-1669367825882.png)
[](https://doc.puq.info/uploads/images/gallery/2022-11/image-1669367860027.png)
Enter or edit the parameters of the new server/interface and click the **ADD** button
# Add server (PUQVPNCP) in WISECP
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
##### 1. Log in to the administrative area of your **[WISECP](https://puqcloud.com/link.php?id=78)**.
#####
2. Go to module configuration.
```
Services -> Service Management -> Module Settings -> Other -> All Modules -> PUQ WireGuard VPN
```
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700485721333.png)
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700485726951.png)
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700485737918.png)
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700485743386.png)
##### 3. In the opened page, click the '**Add Server**' button.
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700485907763.png)
#####
##### 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.
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700486280198.png)
# Service configuration
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
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](https://puqcloud.com/link.php?id=78)**.
##### 2. Create New Service Group
Go to
```
Services -> Service Management -> Add Group
```
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700487270737.png)
Enter all the necessary data and click the '**Create Group**' button.
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700487384497.png)
##### 3. Adding a New Service
Go to
```
Services -> our service group where you need to add the new service.
```
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700487595449.png)
In the opened window, click the '**Create New Service**' button.
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700487653237.png)
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.
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700489009655.png)
##### 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.
# WireGuard clients configuring
# WireGuard Official clients
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
Our solution works great with official client programs. We strongly invite you to use them.
| [](https://panel.puqcloud.com/index.php?rp=/store/puqvpn "https://panel.puqcloud.com/index.php?rp=/store/puqvpn") | [](https://www.wireguard.com/ "https://www.wireguard.com/") |
#### You can download from the [https://www.wireguard.com/install/](https://www.wireguard.com/install/)
Please always download latest versions. The following list is intended as a general direction only.
- - - - - -
#### Windows \[7, 8.1, 10, 11, 2008R2, 2012R2, 2016, 2019, 2022 – v0.5.3\]
[Download Windows Installer](https://download.wireguard.com/windows-client/wireguard-installer.exe)
[Browse MSIs](https://download.wireguard.com/windows-client/)
- - - - - -
#### macOS \[[app store](https://itunes.apple.com/us/app/wireguard/id1451685025?ls=1&mt=12) – v1.0.15\]
[Download from App Store](https://itunes.apple.com/us/app/wireguard/id1451685025?ls=1&mt=12)
- - - - - -
#### Android \[[play store](https://play.google.com/store/apps/details?id=com.wireguard.android) – vunknown – out of date & [f-droid](https://f-droid.org/en/packages/com.wireguard.android/) – v1.0.20220516\]
[Download from Play Store](https://play.google.com/store/apps/details?id=com.wireguard.android)
[Download from F-Droid](https://f-droid.org/en/packages/com.wireguard.android/)
- - - - - -
#### iOS \[[app store](https://itunes.apple.com/us/app/wireguard/id1441195209?ls=1&mt=8) – v1.0.15\]
[Download from App Store](https://itunes.apple.com/us/app/wireguard/id1441195209?ls=1&mt=8)
- - - - - -
#### Debian/Ubuntu
```
$ sudo apt install wireguard
```
- - - - - -
####
# Android WireGuard client configuration
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
In order to connect to a VPN, follow these steps:
1. Open the link you received in a browser to get instructions and configuration for your new VPN connection. And you will see the following page in the browser window
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670928539397.png)
2. Since we are setting up a connection for an android device, we need the WireGuard client for android. To download the client on your phone, open the link on your mobile device and click "Download client Android".
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670931428322-mozilla-firefox.jpg)
3. After you click on the "Download client Android" button, your application store will open, where you need to install your client for Android. Click "Install" to install the application on your mobile device.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670931747373-android-vending.jpg)
4. After completing the app installation, open the app to configure your VPN connection.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670931979459-android-vending.jpg)
5. This is how the main window of the application looks like, which has no configured connections. To set up a new VPN connection, you must press the plus button.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670932117112-wireguard-android.jpg)
6. After you click on the button that allows you to create a new connection, you will be presented with several options. Now we will use the QR code scanning method. Click on the "SCAN FROM QR CODE" button to start scanning.
Later in this manual, **in point number 13**, we will look at creating a connection using a configuration file.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670932306868-wireguard-android.jpg)
7. It is worth noting that if you are using the application for the first time, your device will ask you if you can allow access to the camera. You need to allow access to the camera, otherwise scanning will not be possible.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670932444235-lbe-security-miui.jpg)
8. After you can already start scanning and see that your device is ready, point your camera at the QR code you received.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670932633969-wireguard-android.jpg)
9. After scanning the code, when the scan was successful, the application will prompt you to enter a name for the new connection. Enter a name and save the new configuration by clicking on the "CREATE TUNEL" button.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670932948416-wireguard-android.jpg)
10. After you save your new connection, you will see a list of your VPN connections. Find the required connection to activate it and switch the slider to activation mode.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670933284570-wireguard-android.jpg)
11. It is worth noting that if you have activated your connection for the first time, the system will ask you if it is possible to add such a connection, you must agree that a new connection will be established in order to establish a new connection.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670933447131-android-vpndialogs.jpg)
12. And so, now your connection is established, you can notice that the slider is in activation mode and you can see a special system icon in the notification bar, which indicates that the VPN connection is activated.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670933929090-wireguard-android.jpg)
13. To create a connection using a configuration file: You need to download the configuration file to your mobile device. To download this file, click on the "Dowload config file" button.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670935270396.png)[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670935726727-mozilla-firefox.jpg)
14. Once your configuration file has been downloaded to your device, you need to proceed. You need to return to the "WireGuard" application to import your configuration file. Click "IMPORT FROM FILE OR ARCHIVE" to start importing the configuration file.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670936080006-wireguard-android.jpg)
15. Next, you will be prompted to find your configuration file. You need to find the configuration file and select it.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1671108793041.png)
16. After you select your configuration file, the connection will be created.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670936447601-wireguard-android.jpg)
17. To connect to a new VPN connection, you need to activate the slider opposite to the activate position.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670936682420.png)
# macOS WireGuard client configuration
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
In order to connect to a VPN, follow these steps:
1. Open the link you received in a browser to get instructions and configuration for your new VPN connection. And you will see the following page in the browser window
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670928539397.png)
2. In order to start the configuration you need to download the configuration file. To download the configuration file, click the "Dowload config file" button.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670940579264-46-38.png)
3. Save the file to downloads or any other place to import later.
4. Since we are setting up a connection for an android device, we need the WireGuard client for macOS. To download the client on your device, open the link on your device and click "Download client macOS".
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670940104810-39-21.png)
5. After you click on the "Download client macOS" button, your application store will open, where you need to install your client for macOS. Click "Get" and after "Install" to install the application on your device.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670940223739.png)
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670940268384.png)
6. After completing the app installation, open the app to configure your VPN connection.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670940318349.png)
7. This is how the main window of the application looks like, which has no configured connections. To set up a new VPN connection, you must press the "Import tunel(s) from file" button.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670940440973-46-12.png)
8. Next, you will be prompted to find your configuration file. You need to find the configuration file and select it.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670940871659.png)
9. After you select your configuration file, the connection will be created.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670940911751-48-49.png)
10. Click the "Activate" button. To activate your VPN connection.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670940991508-49-39.png)
11. Congratulations. Your VPN connection is active. We can see this by looking at the system icon bar.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670941094231-50-08.png)
# Windows WireGuard client configuration
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
#####
In order to connect to a VPN, follow these steps:
1. Open the link you received in a browser to get instructions and configuration for your new VPN connection. And you will see the following page in the browser window
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670928539397.png)
2. In order to start the configuration you need to download the configuration file. To download the configuration file, click the "Dowload config file" button.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670940579264-46-38.png)
3. Save the file to downloads or any other place to import later.
4. Since we are setting up a connection for an android device, we need the WireGuard client for Windows. To download the client on your device, open the link on your device and click "Download client Windows".
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670942403983.png)
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670942450081.png)
5. Install the app on your device.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670942686661.png)
6. This is how the main window of the application looks like, which has no configured connections. To set up a new VPN connection, you must press the "Import tunel(s) from file" button.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670942755221.png)
7. Next, you will be prompted to find your configuration file. You need to find the configuration file and select it.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670942837134.png)
8. After you select your configuration file, the connection will be created.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670942895225.png)
9. Click the "Activate" button. To activate your VPN connection.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670942931918.png)
10. Congratulations. Your VPN connection is active.
# Linux WireGuard client configuration
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
#####
In order to connect to a VPN, follow these steps:
1. Open the link you received in a browser to get instructions and configuration for your new VPN connection. And you will see the following page in the browser window
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1670928539397.png)
2. In order to start the configuration you need to download the configuration file. To download the configuration file, click the "Dowload config file" button.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1671007982861.png)
3. Save the file to downloads or any other place to import later. You can download the configuration file and move it to your server, or you can create a new file and copy the configuration text into it. We will copy the configuration text into a new file in this WireGuard client setup guide.
4. Since we are setting up a connection for an Linux device, we need the WireGuard client for Linux. To download and install the client on your device, by command `sudo apt install wireguard`
5. After installing the client, navigate to the folder `cd /etc/wireguard/` and create a configuration file. With the help of the command `nano wg0.conf`
6. Copy the configuration text into your terminal window.
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1671008968309.png)
7. Save the file, after saving the file you need to complete the connection.
Connect using the command: `sudo wg-quick up wg0`
# Mikrotik WireGuard client configuration
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
## Configuring Mikrotik as an WireGuard Client.
##### Make sure you have an up to date **routerOS** system.
Version must be at least: 7.6
```
[admin@VPN-CLIENT] > system package print
Columns: NAME, VERSION
# NAME VERSION
0 routeros 7.6
```
##### Open a single-use shipment on the **WireGuard** section for the client's configuration request
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1671100595697.png)
##### Login to **Mikrotik** via Winbox
Click on the menu item **WireGuard** In the window that opens, in the **WireGuard** tab, click the plus to add a new **WireGuard** interface
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1671100789370.png)
Copy the private key from the text configuration from the **\[Interface\]** section to the **PrivateKey** field in the **WireGuard** interface settings in **Mikrotik**
Click **OK** to create the interface
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1671101049703.png)
Go to the peers tab.
Click plus to add a new peer
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1671101223879.png)
**Interface** - Select the previously created **WireGuard** interface
**Public key** - Copy the public key from the text configuration from the **\[Peer\]** section to the Public key field
**Endpoint** - Copy the server **address** from the text configuration from the **\[Peer\]** section to the endpoint field
**Endpoint Port -** Copy the server **port** from the text configuration from the **\[Peer\]** section to the Endpoint Port field
**Allowed Address -** Copy **AllowedIPs** from the text configuration from the **\[Peer\]** section to the Allowed Address field
**Persistent Keepalive -** Copy the **PersistentKeepalive** from the text configuration from the **\[Peer\]** section to the Persistent Keepalive field
Click **OK** to create a peer
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1671101662963.png)
##### In order to have communication with the server, you need to set the address on the **WireGuard** interface
Go to the menu item **IP->Addresses** In the window that opens, click the plus to assign an IP address to the WireGuard interface
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1671101826333.png)
**Addresse -** Copy the Address from the text configuration from the **\[Interface\]** section to the Address field
**Interface** - Select the previously created **WireGuard** interface
Press the OK button to confirm
[](https://doc.puq.info/uploads/images/gallery/2022-12/image-1671102046038.png)
You also need to configure the traffic routes you need at your discretion.
# iOS WireGuard client configuration
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
In order to connect to a VPN, follow these steps:
1. Open the link you received in a browser to get instructions and configuration for your new VPN connection. And you will see the following page in the browser window
[](https://doc.puq.info/uploads/images/gallery/2023-07/1.png)
2. Since we are setting up a connection for an iOS device, we need the WireGuard client for iOS. To download the client on your phone, open the link on your mobile device and click "Download client iOS".
[](https://doc.puq.info/uploads/images/gallery/2023-07/2.jpg)
3. After you click on the "Download client iOS" button, your application store will open, where you need to install your client for iOS. Click "Install" to install the application on your mobile device.
[](https://doc.puq.info/uploads/images/gallery/2023-07/4.jpg)
4. After completing the app installation, open the app to configure your VPN connection.
[](https://doc.puq.info/uploads/images/gallery/2023-07/3.jpg)
5. This is how the main window of the application looks like, which has no configured connections. To set up a new VPN connection, you must press the plus button or "Add a tunnel" button.
[](https://doc.puq.info/uploads/images/gallery/2023-07/5.jpg)
6. After you click on the button that allows you to create a new connection, you will be presented with several options. Now we will use the QR code scanning method. Click on the "SCAN FROM QR CODE" button to start scanning.
Later in this manual, **in point number 10**, we will look at creating a connection using a configuration file.
[](https://doc.puq.info/uploads/images/gallery/2023-07/6.jpg)
It is worth noting that if you are using the application for the first time, your device will ask you if you can allow access to the camera. You need to allow access to the camera, otherwise scanning will not be possible.
7. After you can already start scanning and see that your device is ready, point your camera at the QR code you received.
It is worth noting the system will ask your password
[](https://doc.puq.info/uploads/images/gallery/2023-07/11.jpg)
[](https://doc.puq.info/uploads/images/gallery/2023-07/6Cc8.png)
[](https://doc.puq.info/uploads/images/gallery/2023-07/image-1690801574494.jpg)
8. After scanning the code, when the scan was successful, the application will prompt you to enter a name for the new connection. Enter a name and save the new configuration by clicking on the "Save" button.
[](https://doc.puq.info/uploads/images/gallery/2023-07/image-1690801637924.jpg)
9. After you save your new connection, you will see a list of your VPN connections. Find the required connection to activate it and switch the slider to activation mode. [](https://doc.puq.info/uploads/images/gallery/2023-07/10.jpg)
10. **To create a connection using a configuration file:** You need to download the configuration file to your mobile device. To download this file, click on the "Dowload config file" button.
[](https://doc.puq.info/uploads/images/gallery/2023-07/photo-5348218480027095645-y.jpg)
11. Once your configuration file has been downloaded to your device, you need to proceed. You need to return to the "WireGuard" application to import your configuration file. Click "Create fron file or archive" to start importing the configuration file.
[](https://doc.puq.info/uploads/images/gallery/2023-07/photo-5348218480027095646-y.jpg)
12. Next, you will be prompted to find your configuration file. You need to find the configuration file and select it.
[](https://doc.puq.info/uploads/images/gallery/2023-07/photo-5348218480027095672-y.jpg)
13. After you select your configuration file, the connection will be created.
14. To connect to a new VPN connection, you need to activate the slider opposite to the activate position.
[](https://doc.puq.info/uploads/images/gallery/2023-07/photo-5348218480027095647-y.jpg)
# Admin Area
# Order Detail
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
Navigate to the service you want to manage, then go to the '**Core**' tab.
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700491305228.png)
In the opened tab, you have a view of the online status of the service. The available online information includes:
- Connection status to the API
- Information about the VPN account on the PUQVPNCP server
- Diagnostic information about the account (online status, firewall rule counters, and so on).
Also, below are fields with the client's personal data, such as Username, Password, Server, and Dedicated IP.
You can also individually override package options for the client by checking the 'Overwrite package settings' box.
After modifying the configuration options, check the '**Send changes to server**' box to save the data to the PUQVPNCP server.
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700491872505.png)
Note: When changing the Server Group, Server, and WireGuard Server fields, make sure you have a user with the username as specified in the 'Username' field pre-created on the new server. Otherwise, you will need to recreate the service for your client.
# Client Area
# Product Home Screen
### WireGuard VPN module **[WISECP](https://puqcloud.com/link.php?id=78)**
##### [Order now](https://puqcloud.com/index.php?rp=/store/wisecp-module-wireguard-vpn) | [Download](https://download.puqcloud.com/WISECP/Product/PUQ_WISECP-WireGuard-VPN/) | [FAQ](https://faq.puqcloud.com/)
##### Available options in the client panel:
- Links in the form of buttons to the instruction and VPN clients
- General information about the service
- Password change option (for IKEv2)
- One-time link generation button for transmitting authorization data
- Option to download WireGuard configuration as a file
- QR code for WireGuard configuration
- Server certificate download button (for IKEv2)
- Download button for the profile for the strongSwan mobile application (for IKEv2)
- VPN connection status
##### Screenshot of the client area
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700430344429.png)
[](https://doc.puq.info/uploads/images/gallery/2023-11/image-1700430111703.png)
#####