Routers
OpenWrt OpenWrt Jun 6, 2026
Posted Sat, Jun 6, 2026 10:13 AM

How to setup OpenVPN on OpenWrt

This guide was created by a community member and reviewed by us. Firmware and router interfaces may change over time, so some steps may differ depending on your device or version.

Prerequisites:

  • Make sure your OpenWrt version is 25.12 or newer.

  1. Open the OpenWrt LuCI web interface and log in to your router.

  2. In LuCI, go to System -> Software.

  3. Click the "Update lists" button and wait for the package lists to update.

  4. After the update is complete, use the "Filter" field to search for and install the following packages:

    • openvpn-openssl
    • luci-app-openvpn
  5. Once the installation is finished, refresh the LuCI web interface page.

  6. Log in to your Xeovo dashboard and download the OpenVPN configuration file for your preferred country. Select the Linux configuration.

  7. In LuCI, navigate to VPN -> OpenVPN.

  8. Under "OVPN configuration file upload", enter an instance name (for example, xeovo) and import the configuration file you downloaded from Xeovo.

  9. After importing the configuration, open the newly created instance for editing.

  10. Make the following changes to the configuration file:

    • Remove the following lines:
            up /etc/openvpn/update-resolv-conf
            down /etc/openvpn/update-resolv-conf
    • Locate the line:
            auth-user-pass
      and change it to:
            auth-user-pass /etc/openvpn/<instance-name>.auth
      Example:
            auth-user-pass /etc/openvpn/xeovo.auth
    • At the bottom of the editor, add your Xeovo account credentials:
      • First line: Xeovo username
      • Second line: Xeovo password
  11. Click "Save" to save the edited configuration.

  12. Navigate to Network -> Interfaces.

  13. Click the "Add new interface" button and enter the following configuration:

    • Name – Give it any name, for example, xeovo

    • Protocol – Unmanaged

    • Devicetun0

      Click "Create", then "Save & Apply" to save the interface.

Add a Firewall Zone

  1. Navigate to Network -> Firewall.

  2. Click the "Add" button and enter the following configuration:

    • Name – Give it any name, for example, xeovo

    • Input – Reject

    • Output – Accept

    • Forward – Reject

    • Masquerading – Enabled

    • MSS Clamping – Enabled

    • Covered Networks – Select the VPN tunnel interface you created earlier

    • Allow forward to destination zones – Unspecified

    • Allow forward from source zoneslan

  3. Click "Save & Apply" to apply the firewall settings.

  4. After applying the firewall configuration, reboot your OpenWrt router to ensure all network and firewall changes are properly initialized.

Your OpenVPN connection is now configured and active on your OpenWrt router.

To verify that the VPN connection is working correctly, visit:

https://doesmyvpn.work