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.
Provisioning menu with the Catalog option highlighted
  • Select catalog item MTN WireGuard SSL VPN.
Catalog view with the MTN WireGuard SSL VPN item available for order
  • 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
Order form for MTN WireGuard SSL VPN showing Group, Cloud, Environment, and instance configuration fields
  • Click Order Now.

Verify Deployment

  • Navigate to: Provisioning > Instances.
Instances list showing the newly provisioned WireGuard SSL VPN instance
  • Select the WireGuard SSL VPN instance to view additional details.
Instance summary view showing provisioning progress and ETA

Retrieve VPN Management URLs

  • Once provisioning is complete, open the Console tab.
Console tab showing a remote session for the WireGuard SSL VPN instance
  • 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.
Console output showing VPN server details, WG-Easy Web UI URL, and Traefik dashboard URL

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.

Create Instance wizard with MTN WireGuard SSL VPN selected

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.

Browser privacy warning shown when first accessing the SSL VPN URL
  • Click Advanced, then select Continue.

Admin Account Setup

  • On the welcome screen, click Continue.
WG-Easy welcome screen with the initial Continue button
  • Enter an admin Username and Password (minimum 12 characters).
WG-Easy setup screen with Username, Password, and Confirm Password fields
  • When asked if you have an existing setup, click No.
WG-Easy screen asking whether you have an existing setup, with No selected
  • Enter the Host (public IP address of the WireGuard SSL VPN instance) and Port (51820), then click Continue.
WG-Easy screen with Host and Port fields for client configuration
  • Once setup completes, click Sign In.
WG-Easy Setup successful confirmation screen with Sign In button

Sign In

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

WG-Easy sign-in screen with username and password fields

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

WG-Easy Clients dashboard, empty on first login

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.
WireGuard desktop application with the Import tunnel(s) from file option
  • 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.
WireGuard tunnel detail view showing interface and peer settings, with the Activate button

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.
Terminal output showing the contents of /etc/wireguard/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