--- title: Working with Managed VPN description: "![](http://truehost.com/support/wp-content/uploads/2026/06/wireguard-1024x576.webp) # Purpose This guide explains how to use the managed Truehost Cloud VPN powered by WireGuard vpn. It covers: - First-time login and service activation - Enabling WireGuard interface (wg0) - Creating VPN clients - Downloading configurations - Managing…" url: "https://truehost.com/support/knowledge-base/working-with-managed-vpn/" updated: "2026-06-07" category: Managed Applications --- # Working with Managed VPN ![](http://truehost.com/support/wp-content/uploads/2026/06/wireguard-1024x576.webp) # Purpose This guide explains how to use the managed Truehost Cloud VPN powered by WireGuard vpn. It covers: - First-time login and service activation - Enabling WireGuard interface (wg0) - Creating VPN clients - Downloading configurations - Managing VPN connectivity - System tools and diagnostics - Troubleshooting # First Login After provisioning, you will receive: - Dashboard URL - Username - Password Prerequisites Install WireGuard on client devices/endpoints: [https://www.wireguard.com/install](https://www.wireguard.com/install) ## Step 1: Login Open your dashboard URL: ``` https://your-instance.truehost.biz ``` Log in using the provided credentials. ![](https://truehost.com/support/wp-content/uploads/2026/06/image-3-1024x537.png) ## Step 2: Critical First Action — Enable VPN Interface (wg0) After login, the VPN is NOT active by default. You must manually start the WireGuard interface. Navigate to: **WireGuard Configurations → wg0** ![](https://truehost.com/support/wp-content/uploads/2026/06/image-4-1024x537.png) ### Step 3: Start wg0 On the top right of the dashboard, toggle the status button to activate the interface: **Start** Wait for status to change to: > On / Active > > > > A popup message will appear on success or failure. ![](https://truehost.com/support/wp-content/uploads/2026/06/image-5-1024x537.png) ### WARNING If **wg0 is not started**, then: - VPN clients will NOT connect - No traffic will pass through the VPN - QR codes/configs will not function correctly # Dashboard Navigation Overview The dashboard includes the following sections: | Section | Function | | --- | --- | | Home | System overview | | Settings | System and VPN configuration | | Clients | Manage VPN users (i.e., users signed up via the client sign up page) | | Webhooks | Event automation | | Help | Documentation and version info | | WireGuard Configurations | VPN tunnel control | | Tools | Network diagnostics | | System Status | Server health monitoring | | Sign Out | Exit dashboard | ![](https://truehost.com/support/wp-content/uploads/2026/06/image-6.png) # Creating VPN configurations for clients (Peers) All VPN devices are created under: ## WireGuard Configurations >> Interface In this case, we will be using: WireGuard Configurations >> wg0 ## Step 1: Open WireGuard Configurations >> wg0 Click on the +Peer button on the top right: ![](https://truehost.com/support/wp-content/uploads/2026/06/image-7-1024x511.png) ![](https://truehost.com/support/wp-content/uploads/2026/06/image-8-1024x511.png) ## Step 2: Configure peer Fill in: ### Required Fields - **Client Name** Example: `John-Laptop`, `Office-PC`, `Android-Phone` ### Optional Fields Leaving the other fields at their defaults is safe; you can, however, modify the settings as you wish, provided you are familiar with the troubleshooting process. ### The system automatically generates: QR code (mobile use) WireGuard private/public keys Client configuration file ![](https://truehost.com/support/wp-content/uploads/2026/06/image-9-1024x511.png) ## Step 3: Save Peer Click: **Add** ![](https://truehost.com/support/wp-content/uploads/2026/06/image-10-1024x511.png) # Downloading VPN Configuration After creating a peer, you must install the configuration on the device. ## Option 1: Configuration File (.conf) On the created peer, click on the 3 dots (...) and then download the configuration file: **Download Config** ![](https://truehost.com/support/wp-content/uploads/2026/06/image-11-1024x511.png) Configuration is compatible with the below clients: - Windows - Linux - macOS - Servers ## Option 2: QR Code (Mobile Devices) Click: **Show QR Code** ![](https://truehost.com/support/wp-content/uploads/2026/06/image-12-1024x511.png) Scan using the clients below: - WireGuard (Android) - WireGuard (iOS) # Managing WireGuard Interface (wg0) Navigate to: **WireGuard Configurations → wg0** This is the core VPN tunnel. You can adjust the configurations using the "Configuration Settings" button. ![](https://truehost.com/support/wp-content/uploads/2026/06/image-13-1024x511.png) ## Stop VPN Toggle the status button to off: ![](https://truehost.com/support/wp-content/uploads/2026/06/image-14-1024x511.png) ### WARNING Stopping wg0 will: - Disconnect ALL users - Stop all VPN traffic - Make VPN clients unusable until restarted # System Status Navigate to: **System Status** Used for monitoring server health. You can view: - CPU usage - RAM usage - Disk usage - Service uptime - WireGuard status ![](https://truehost.com/support/wp-content/uploads/2026/06/image-15-1024x511.png) # Network Diagnostic Tools Navigate to: **Tools** ## Ping Tool Used to test connectivity to a host. ![](https://truehost.com/support/wp-content/uploads/2026/06/image-16-1024x511.png) ## Traceroute Tool Used to trace network routing paths. ![](https://truehost.com/support/wp-content/uploads/2026/06/image-17-1024x511.png) # Settings Navigate to: **Settings** Used to configure: - VPN network settings - DNS behavior - Interface options - Security settings - Authentication settings (including optional 2FA) ![](https://truehost.com/support/wp-content/uploads/2026/06/image-18-1024x511.png) # Webhooks Navigate to: **Webhooks** Used for automation and integrations. Typical use cases: - Client creation notifications - Billing system integration - Security alerts - External logging systems ![](https://truehost.com/support/wp-content/uploads/2026/06/image-19-1024x511.png) # Mapping peer configuration to registered clients By default, client signup is enabled, and users can sign up by visiting https:///client ![](https://truehost.com/support/wp-content/uploads/2026/06/image-20-1024x511.png) For security purposes, clients are required to have OTP enabled, and setup is required on first signup: ![](https://truehost.com/support/wp-content/uploads/2026/06/image-21-1024x511.png) Once a client is registered, you can assign them a peer from the admin area by navigating to: Clients >> Click on the client >> Click "Manage" >> Click "+" on the respective peer configuration ![](https://truehost.com/support/wp-content/uploads/2026/06/image-22-1024x511.png) The client will now be able to view and download the configurations granted access to from the client side: ![](https://truehost.com/support/wp-content/uploads/2026/06/image-23-1024x511.png) # Signing Out Click: **Sign Out** Always sign out when using shared or public devices. # Troubleshooting ## VPN Not Working After Setup Check: 1. wg0 interface is running 2. Device has internet access 3. Firewall allows UDP traffic (WireGuard port) ## Clients Cannot Connect Check: - wg0 is active - Client is correctly created - The configuration file is not reused - Endpoint IP/hostname is correct ## No Internet Over VPN Check: - DNS settings in client config - Allowed IPs configuration - NAT rules on server ## Dashboard Not Loading Check: - Correct URL - Server is running - Firewall/security group rules ## Lost Access to VPN If VPN stops working completely: 1. Check **WireGuard Configurations → wg0** 2. Restart wg0 3. Regenerate client config if necessary # Support For assistance: 📧 [support@truehost.cloud](mailto:support@truehost.cloud) Include: - VPN URL - Username - Temporary password via https://pass.cloudoon.com/ - Issue description - Screenshots (if possible)