Voidly

Voidly help

Less stuck.
More done.

Set up your device. Find the fix. Keep your keys safe.

Set up a device Find a fix
GenerateImportCheck the client

Setup steps. Connection is checked on your device.

01 / VPN

Your device.
Your next step.

WireGuard setup for phone and desktop.

Choose a platform ↗02 / MAIL

An inbox.
A key to keep.

Account setup, aliases and key recovery.

Email setup ↗03 / STATUS

Check the
service first.

Read operational checks and their timestamps.

Service status ↗

Manual WireGuard setup

Pick your device.

Use an official WireGuard client with a configuration from Voidly. The Voidly desktop app has a separate install and built-in client.

The configuration is private.

It contains a private key. Do not post it, photograph its QR code, or send it to support. Manual WireGuard configurations do not run a probe or contribute measurements.

iPhone & iPadOfficial WireGuard app
  1. Install WireGuard from the App Store.
  2. Open the configuration generator. Follow any sign-in or availability message, choose a node, and select Generate Config.
  3. On the same phone, select Download Config. Find the .conf file in Files, share it to WireGuard or use WireGuard’s file import.
  4. With a second device, you can display the generator’s QR code there. In WireGuard tap +, choose Create from QR code, and scan it. Give the tunnel a recognizable name and save.
  5. Switch on the imported tunnel and allow the VPN permission prompt.

Activate the imported tunnel, allow the operating system’s VPN prompt, then check the client’s handshake and traffic counters. A downloaded file is not a connected VPN.

If permission was declined, check the device’s VPN permissions and retry activation. Read the client’s actual error before changing other settings.

AndroidOfficial WireGuard app
  1. Install WireGuard from Google Play.
  2. Generate a configuration at Voidly VPN. Address any generator error before continuing.
  3. On the same phone, download the .conf file. In WireGuard tap + and use Import from file or archive; select it from Downloads.
  4. Alternatively, display the QR on a second device and choose Scan from QR code. Name the tunnel and select Create Tunnel.
  5. Toggle the tunnel on and allow Android’s VPN prompt.

Activate the imported tunnel, allow the operating system’s VPN prompt, then check the client’s handshake and traffic counters. A downloaded file is not a connected VPN.

Optional: once the connection works, review Android’s VPN settings for an always-on option if your device supports it. Check what any “block connections without VPN” option does before enabling it.

WindowsImport a configuration file
  1. Get the official client from WireGuard’s installation page.
  2. Use Generate Config, then Download Config.
  3. In WireGuard select Import tunnel(s) from file, and choose the downloaded .conf file.
  4. Select the tunnel and Activate. Approve the operating system prompt where required.

Activate the imported tunnel, allow the operating system’s VPN prompt, then check the client’s handshake and traffic counters. A downloaded file is not a connected VPN.

If a firewall or security product blocks the client, review its WireGuard-specific rule or ask your administrator. Keep the firewall enabled.

macOSApp Store or Homebrew

App Store setup

  1. Install WireGuard using the macOS App Store link on the official installation page.
  2. Generate and download your .conf file at Voidly VPN.
  3. Open WireGuard, import the configuration file, and select Activate.
  4. Approve the macOS VPN/network extension request if shown.

Activate the imported tunnel, allow the operating system’s VPN prompt, then check the client’s handshake and traffic counters. A downloaded file is not a connected VPN.

Command-line setup with Homebrew

If Homebrew is not installed, review the installer and requirements at brew.sh. The published installer command is below; running it installs software on your Mac.

Homebrew installer
/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"

Install WireGuard tools on macOS
brew install wireguard-tools

Download one configuration from the generator. In your file manager, rename that file to voidly.conf in Downloads. Use a different short name if it would overwrite another configuration, and match that name in the commands. The generated filename can be too long for a command-line interface name.

Restrict configuration access
chmod 600 "$HOME/Downloads/voidly.conf"

Start the selected tunnel
sudo wg-quick up "$HOME/Downloads/voidly.conf"

Stop the selected tunnel
sudo wg-quick down "$HOME/Downloads/voidly.conf"

These commands use one exact file path. Keep the file while the tunnel is running. Only run a configuration you trust; WireGuard configuration files can include commands.

Read the official wg-quick manual for configuration paths and options.

LinuxUbuntu, Debian, Arch, Fedora & RHEL

1. Install the tools

Choose your distribution. For older releases or RHEL, check kernel and repository requirements in WireGuard’s installation guide before running a package command.

Ubuntu / Debian
sudo apt update
sudo apt install wireguard

Arch Linux
sudo pacman -S wireguard-tools

Fedora / RHEL with the required repositories
sudo dnf install wireguard-tools

2. Use your configuration

Download one configuration from the generator. In your file manager, rename that file to voidly.conf in Downloads. Use a different short name if it would overwrite another configuration, and match that name in the commands. The generated filename can be too long for a command-line interface name.

Restrict configuration access
chmod 600 "$HOME/Downloads/voidly.conf"

Start the selected tunnel
sudo wg-quick up "$HOME/Downloads/voidly.conf"

Stop the selected tunnel
sudo wg-quick down "$HOME/Downloads/voidly.conf"

These commands use one exact file path. Keep the file while the tunnel is running. Only run a configuration you trust; WireGuard configuration files can include commands.

Activate the imported tunnel, allow the operating system’s VPN prompt, then check the client’s handshake and traffic counters. A downloaded file is not a connected VPN.

Optional: start at boot with systemd

Only after the tunnel works: put the selected file at /etc/wireguard/voidly.conf with root ownership and permissions 600. Create the directory if needed. Do not overwrite an existing tunnel; match its name in the service command. This optional setting starts the tunnel on later boots.

Enable the selected tunnel at boot
sudo systemctl enable wg-quick@voidly

Undo automatic startup
sudo systemctl disable wg-quick@voidly

Disabling startup does not stop an already running tunnel. Use the matching client stop command. See the official configuration reference.

More detail: VPN setup guide · Network and protocol limits · Desktop installation and platform limits

Find the next check

Where did it stop?

No connectionGenerator, import or handshake
  1. If the generator reports a sign-in or availability error, follow that message. Do not import a partial or old result as a workaround.
  2. If the file opens as text, save it as a .conf file and import it into WireGuard. Do not paste it into another website.
  3. Check whether ordinary internet access works with the tunnel off. Turning it off uses your ordinary connection.
  4. Read the WireGuard error and check whether a handshake completes. Allow the client’s required VPN permissions and review app-specific firewall rules.
  5. If a selected node fails, try a new configuration for another available node. Manual configuration uses WireGuard over UDP; some networks block it. No alternative transport is offered in this flow.

Follow the routing instructions for your WireGuard client and operating system. A public IP lookup alone does not verify routing, DNS or protection.

Websites won’t loadDNS, browser or an old configuration
  1. Check for a handshake and traffic first. If neither appears, use the connection checks above.
  2. Check the DNS values in your newly generated configuration and any resolver error. Public resolvers such as 1.1.1.1 and 8.8.8.8 are examples, not instructions to override the generated values.
  3. Check whether a browser proxy or extension is intercepting the connection. Try another browser or a private window.
  4. If only one site fails, consider clearing that site’s cached data. Removing cookies signs you out.
  5. Regenerate and import a configuration if the original has expired. Check the current generator’s availability.
The connection is slowCompare before changing settings
  1. Compare the same task with the VPN on and off. The off test uses your ordinary connection.
  2. Try an available node closer to you, then import and activate its configuration.
  3. Check whether the local network is already slow or congested. Record which node, time and device showed the issue.

Performance varies by route, network and device; no fixed slowdown percentage is guaranteed.

Still stuck?

The right inbox.

Include the product, device, node if relevant, time, exact error and what you tried. Remove private information from screenshots. Never send passwords, configuration files, private keys or recovery phrases.

Technical supportsupport@voidly.ai ↗General & businessinfo@voidly.ai ↗Securitysecurity@voidly.ai ↗Privacyprivacy@voidly.ai ↗

For bugs, feature requests and discussions: Voidly on GitHub. Do not post account details or keys in public issues.