MTN WireGuard SSL VPN Provisioning Workflow on MTN Cloud
Overview
The MTN WireGuard SSL VPN is a high-performance VPN instance built on the WireGuard protocol, purpose-built for the MTN Cloud. It provides secure, reliable remote access to your private networks, managed through a browser-based web interface rather than manual configuration.
Why it matters:
- Remote Cloud Access: Enables secure connections into your private cloud networks from anywhere.
- Simplified Management: A web UI (WG-Easy) handles client creation, key generation, and connection monitoring — no manual key handling required.
- Secure Channel: WireGuard’s modern cryptography keeps traffic between clients and your cloud resources encrypted end-to-end.
Prerequisites
Before you begin, ensure you have:
- An active MTN Cloud login with permissions to view Provisioning (Instances and Catalog) and Infrastructure (Network).
- A security group already defined for this deployment. For guidance on creating one, reference the Security Group Creation documentation.
- A deployment plan for the VPN instance (sizing, environment, network placement).
Tip: If you don’t see required features and resources, contact support or refresh the portal.
Important Note: Ports 51820 (UDP), 53, and 443 must be added as inbound rules in the personal security group and applied to the SSL VPN server, alongside the default security group.
Deploy MTN WireGuard SSL VPN
Provision via Catalog
- Navigate to: Provisioning > Catalog.

- Select catalog item MTN WireGuard SSL VPN.

- Assign the following fields:
- Group
- Cloud
- Environment
- Name
- Resource Pool
- Plan
- Volumes
- Network(s)
- Security Groups (default and the security group created earlier)
- Floating IP

- Click Order Now.
Verify Deployment
- Navigate to: Provisioning > Instances.

- Select the WireGuard SSL VPN instance to view additional details.

Retrieve VPN Management URLs
- Once provisioning is complete, open the Console tab.

- The instance includes a reverse proxy, giving secure access to the Web UI from the internet. The console output displays the VPN server details and the URLs needed to reach the management interface.

Alternative Provisioning
The instance can also be provisioned via the Instances tab — the same way you would normally create an instance or virtual machine — by selecting the MTN WireGuard SSL VPN instance type.

SSL VPN Web Setup
With your security group created and your WireGuard SSL VPN instance deployed, open the provided WG-Easy URL in a web browser.
Initial Access
Your browser will show a certificate warning, since the instance uses a self-signed certificate by default.

- Click Advanced, then select Continue.
Admin Account Setup
- On the welcome screen, click Continue.

- Enter an admin Username and Password (minimum 12 characters).

- When asked if you have an existing setup, click No.

- Enter the Host (public IP address of the WireGuard SSL VPN instance) and Port (51820), then click Continue.

- Once setup completes, click Sign In.

Sign In
Use the username and password you created earlier to sign in.

Once signed in, you’ll land on the Clients dashboard, where VPN clients can be created and managed.

Onboarding Clients
End users connect by importing a generated WireGuard configuration file or scanning a QR code on mobile devices.
Important Note: Allowed IPs is the fundamental traffic filter within a WireGuard configuration — a hybrid between a network router and a security firewall, defining the CIDR ranges authorised for a given peer. Common use cases:
- 0.0.0.0/0 (Full Tunnel): Routes all internet traffic through the VPN server.
- 10.8.0.0/24 (Split Tunnel): Routes only VPN-internal traffic; local internet/SSH stay active.
- Custom Subnets (e.g., 10.253.253.0/24): Routes traffic to specific private cloud networks or data centres.
All clients start by downloading and installing WireGuard from wireguard.com/install.
Windows & macOS Users
- Import or download the .conf file via the WireGuard server web UI for the relevant client.
- Open the WireGuard application.

- Click Import Tunnel(s) from file, locate the .conf file, and click Open.
- Edit the .conf file to match your desired settings, if needed.
- Click Activate to start the VPN connection.

Linux Users
- Install openresolv so WireGuard can use the server’s DNS:
- sudo apt install openresolv -y
- Download or import the config from the WireGuard server web UI (e.g., clientname.conf), move it to the default WireGuard directory, and rename it to match the network interface — typically wg0.conf.

- Secure the file permissions so only root can read the private keys:
- sudo chmod 600 /etc/wireguard/wg0.conf
- Edit the .conf file to match your desired settings.
- Bring up the VPN tunnel:
- sudo wg-quick up wg0
- Verify the connection:
- sudo wg show
- (Optional) Enable the tunnel on boot:
- sudo systemctl enable wg-quick@wg0
Important Tips & Notes
- This service manages VPN clients through a secure web interface, automatically generates client keys and configuration files, and provides real-time visibility into client connections and traffic usage.
- The Web UI is accessed through a Traefik reverse proxy, which also provides its own management interface. The default username and password are both “Administrator.”
- End users connect by importing a generated WireGuard configuration file or scanning a QR code on mobile devices — no manual key handling required.
- If the WireGuard VPN blocks internet access immediately after a client connects, restart the WireGuard services on the server. This may take more than one restart before connectivity is restored:
- cd /etc/docker/containers/wg-easy
- sudo docker compose restart