Creating and Managing WireGuard Users

Last updated 15 Mar 2026 · 5 views

Each device you want to connect to your Dedicated WireGuard Server needs its own WireGuard user. A user generates a unique cryptographic key pair and a configuration file that you import into the WireGuard app on that device.

Creating a User

  1. Go to WireGuard Servers from your Dashboard.
  2. Click "Manage Server" on your server.
  3. In the "Create WireGuard User" section at the top, enter a name for this user. Use a descriptive name so you can identify which device it belongs to — for example laptop, phone, gaming-pc, or work-desktop.
  4. Click "Create User".

The system will connect to your server, generate a unique key pair, and assign the next available internal IP address. This takes a few seconds.

Naming Rules

User names can only contain letters, numbers, hyphens (-) and underscores (_). Spaces and special characters are not allowed. Names are scoped to your account, so other customers can use the same names on their own servers without conflict.

Downloading the Configuration File

After creating a user, you will see it listed on the management page. Each user has a "Download .conf" button. Click it to download a WireGuard configuration file.

This .conf file contains everything the WireGuard app needs to connect: the client's private key, the server's public key, a preshared key for additional security, the server's IP address and port, and DNS settings.

Importing the Configuration

Windows

  1. Download and install WireGuard from wireguard.com/install.
  2. Open WireGuard and click "Import tunnel(s) from file".
  3. Select the .conf file you downloaded.
  4. Click "Activate" to connect.

macOS

  1. Install WireGuard from the Mac App Store.
  2. Open WireGuard and click "Import Tunnel(s) from File".
  3. Select the .conf file.
  4. Click "Activate".

iOS

  1. Install WireGuard from the App Store.
  2. Open the app and tap the + button.
  3. Choose "Create from file or archive" and select the .conf file, or scan the QR code if you have one.
  4. Tap "Activate".

Android

  1. Install WireGuard from the Play Store.
  2. Open the app and tap the + button.
  3. Choose "Import from file or archive" and select the .conf file.
  4. Tap the toggle to connect.

Linux

  1. Install WireGuard: sudo apt install wireguard (Ubuntu/Debian).
  2. Copy the .conf file to /etc/wireguard/wg-client.conf.
  3. Connect: sudo wg-quick up wg-client.
  4. To disconnect: sudo wg-quick down wg-client.

Removing a User

If you no longer need a user (for example, you've replaced a device), click the red "Remove" button next to that user. This will:

  • Remove the peer from the WireGuard server immediately
  • Remove all port forwarding rules associated with that user
  • Delete the user from your account

This action cannot be undone. The configuration file for that user will no longer work.

FAQs

How many users can I create?

There is no hard limit. The WireGuard subnet supports up to 253 users per server, which is more than enough for any use case.

Can I reuse a name after removing a user?

Yes. Once a user is removed, the name and IP address become available again.

Can I rename a user?

Not directly. Remove the user and create a new one with the desired name. You will need to re-import the new configuration file on your device.

My configuration file says the private key is "IMPORTED_NO_KEY". What does that mean?

This means the user was imported from an existing server rather than created through the portal. The private key exists only on the original client device. You cannot download a new config for imported users — use the original config file instead.

Dedicated WireGuard VPN All Articles