The simplest and fastest way to install WireGuard UI is to use the Portainer template provided by our team. This method minimizes manual configuration and allows you to deploy a stable, ready-to-use setup in just a few minutes.
Requirements
- A VPS with Portainer installed using the Unihost script
- A deployed NPM (Nginx Proxy Manager)
After Portainer is installed, log in with your credentials.
Inside Portainer, go to the local section, select WireGuard, and fill in the fields:
name — the name of the stack or container, for example wireguard
Public Host/IP — the domain that will be used through NPM. If you don’t have a domain, you can specify the server’s IP address (additional configuration will be described below)
Web UI Admin Password — the password for accessing the WireGuard interface
Now go to NPM and add a proxy for WireGuard.
In the Domain Names field, you can specify the server’s IP address (if you don’t have a domain).
In this case, an error will appear:
“You can’t log in with an insecure connection. Use HTTPS.”
If you have a domain, specify it, link it to WireGuard, and issue an SSL certificate.
If you don’t have a domain, you can enable insecure mode by changing the INSECURE parameter from false to true. Keep in mind that this is an insecure method and is not recommended for regular use.
How to do this:
Go back to Portainer:
Stacks → select your wireguard stack → Editor
Find the INSECURE line and change the value from false to true.
After changing the parameter, click Update the stack. The error will disappear, and you will be able to log in to the WireGuard panel.
Use the credentials you specified when deploying the stack to connect to WireGuard.
Now proceed to creating a configuration for the VPN.
Click New Client and fill in the fields.
name — the username for the profile, you can specify any value
Expire Date — the expiration date of the connection. You can set an end date or leave this field empty if no restriction is required
We have created a new client, and now you can download the configuration file for your PC to connect to the VPN.
(You can also use a QR code, but this step is omitted in this guide.)
After downloading the file, you need to add the configuration to your VPN connection and start it.
Linux/Ubuntu 24.04
Open the top panel and select VPN Settings.
Click + and select Import from file.
After adding the profile, you will see the new VPN connection created in WireGuard.
WireGuard Settings
Windows
Download and install the WireGuard application from the official website:
https://www.wireguard.com/install/
After installation, import your configuration file.
After that, you will be able to fully use the VPN.
Conclusion
Using the ready-made Portainer template saves time and reduces the chance of errors. As a result, you get a fully functional VPN out of the box with minimal setup effort.