Linux command line logo

Command line (bash, zsh, fish)

These steps use the standard OpenVPN command-line client. The same commands work in bash, zsh, and fish; only your shell prompt looks different.

  1. Sign in to your Wirelayer account and download the .ovpn configuration file for the server you want to use.
  2. Install the OpenVPN client from your distribution repositories if it is not already installed.
  3. Open your terminal in bash, zsh, or fish and run:
    • sudo openvpn --config /path/to/your-profile.ovpn
  4. If your shell path contains spaces, quote it exactly the same way in bash, zsh, or fish.
  5. When OpenVPN prompts for credentials, enter the username and password from your Wirelayer welcome email or control panel.
  6. Leave the terminal window open while the VPN session is active.
  7. To disconnect, return to the terminal and press Ctrl+C.

If you want a reusable system profile later, move the configuration into your distribution's OpenVPN client directory and start it with your init system. For a first connection, the direct command above is the fastest method.

GNOME logo

GNOME

These steps assume your Linux desktop uses GNOME with NetworkManager. Use the Wirelayer .ovpn profile from your customer area.

  1. Download the .ovpn configuration file for the server you want to use.
  2. Open Settings and go to Network.
  3. Open the VPN section and choose the option to Add or Import from file.
  4. Select your downloaded .ovpn file.
  5. When prompted, enter your Wirelayer username and password.
  6. Save the profile and turn the VPN connection on.
  7. Later, you can reconnect from Settings > Network > VPN or from the system menu.

If GNOME does not offer an OpenVPN import option, install the NetworkManager OpenVPN plugin from your distribution and try again.

KDE Plasma logo

KDE Plasma

These steps assume your system uses KDE Plasma with the normal network management tools.

  1. Download the Wirelayer .ovpn profile for the server you want to use.
  2. Open System Settings and go to Network or Connections.
  3. Choose the option to add a new connection and then Import VPN connection or Import from file.
  4. Select the downloaded .ovpn file.
  5. Enter your Wirelayer username and password when asked.
  6. Save the profile and connect from the network applet in the panel.

If the import option is missing, install the OpenVPN support package for your network manager stack and reopen the settings panel.

LXQt logo

LXQt

Most LXQt systems use a lightweight NetworkManager applet or the nm-connection-editor utility for VPN setup.

  1. Download the Wirelayer .ovpn profile for the server you want to use.
  2. Open your network applet's connection editor, or run nm-connection-editor from the application menu or terminal.
  3. Create a new connection and choose Import a saved VPN configuration or Import from file.
  4. Select the downloaded .ovpn file.
  5. Enter your Wirelayer username and password if prompted.
  6. Save the profile and connect from the panel network menu.

If your LXQt installation does not use NetworkManager, fall back to the command-line instructions above.

Xfce logo

Xfce

Most Xfce systems use the NetworkManager applet for VPN connections.

  1. Download the Wirelayer .ovpn profile you want to use.
  2. Open the network applet menu and choose Edit Connections, or run nm-connection-editor.
  3. Add a new connection and choose Import a saved VPN configuration.
  4. Select the downloaded .ovpn file.
  5. Enter your Wirelayer username and password when prompted.
  6. Save the profile and connect using the network applet in the panel.

If OpenVPN import is unavailable, install the NetworkManager OpenVPN plugin for your distribution and reopen the connection editor.

MATE logo

MATE

Most MATE systems use the classic NetworkManager connection editor for VPN profiles.

  1. Download the Wirelayer .ovpn profile for the server you want to use.
  2. Open the network menu and choose Network Connections, or run nm-connection-editor.
  3. Add a new connection and choose Import a saved VPN configuration.
  4. Select the downloaded .ovpn file.
  5. Enter your Wirelayer username and password when requested.
  6. Save the profile and connect from the network applet in the panel.

If the import entry is missing, install the OpenVPN plugin for NetworkManager and try again.