install openvpn-openssl and luci-app-openvpn
A new page in the Luci web interface should appear.
Click on VPN button in the bar and then on OpenVPN to open the OpenVPN config managment page (provided by the luci-app-openvpn package you just installed)
Create a new config with the “Template-based configuration” line by choosing the template, writing a name and clicking Add button to create it.
Then it will appear in the table and you can edit this configuration file by clicking on Edit button to open the edit page for this configuration.
This is available from OpenWrt 19.07 onwards.
All self-respecting commercial OpenVPN providers will offer self-sufficient OpenVPN config files you can load in your consumer router or network appliance to connect to their service.
You can use them in OpenWrt too.
Use the “OVPN configuration file upload” to give a name and upload one of such config files.
It will appear in the table of available OpenVPN configurations.
If your provider requires you to write your username and a password, click on the Edit button, and in the edit page, write your username and password in the second text box, as shown in this example
Now edit the line beginning auth-user-pass in the first text box to included the full path to the username/password .auth file. The full path is visible just above the second text box. For above example:
Start the client by pressing on the Start button in the table of available configurations. OpenVPN startup and shutdown are slow, it can take up to 10 seconds to complete.
If you want this VPN client connection to be started on boot and always active, click in the Enable checkbox of its line in the table.
Note: If clicking on Start button in the table does not start the VPN instance. Tick the Enable checkbox, and press Save & Apply button to start the VPN instance
At this point the VPN is set up and the router can use it, but devices in the LAN of your router won't be able to access the internet anymore.
We need to set the VPN network interface as public by assigning VPN interface to WAN zone.
tun0, Protocole =
Unmanaged, Interface =
tun0. Then click on Create Interface.
Click on Network in the top bar and then on Firewall to open the firewall configuration page.
Click on the Edit button of the wan (red) zone in the Zones list at the bottom of the page.
Click on the Advanced Settings tab and select the tunX interface (tun0 in the screenshot, which is the most likely if you have a single OpenVPN client/server running)
You can see the interface name if you click on Status on the top bar and then click on System Log.
A few lines from the system log where you can see the interface name of the OpenVPN client started with the configuration file “NLMiramUDP443E3”
Fri Aug 30 11:28:32 2019 daemon.notice openvpn(NLMiramUDP443E3): TUN/TAP device tun0 opened Fri Aug 30 11:28:32 2019 daemon.notice openvpn(NLMiramUDP443E3): TUN/TAP TX queue length set to 100 Fri Aug 30 11:28:32 2019 daemon.notice openvpn(NLMiramUDP443E3): /sbin/ifconfig tun0 10.24.74.134 netmask 255.255.255.0 mtu 1500 broadcast 10.24.74.255
Establish the VPN connection. Verify your client traffic is routed via VPN gateway.
traceroute openwrt.org traceroute6 openwrt.org
Check your client public IP addresses.
Make sure there is no DNS leak on the client side.
Delegate a public IPv6 prefix to VPN6 network to use IPv6 by default.
If you discover DNS is not working, use LuCI and navigate to Network → Interfaces → LAN, and add your preferred DNS servers (eg. Google's 22.214.171.124, 126.96.36.199) to 'Use Custom DNS' fields.
Open a ssh remote terminal connection to the router.
Collect and analyze the following information.
# Restart services /etc/init.d/log restart; /etc/init.d/openvpn restart; sleep 10 # Log and status logread -e openvpn; netstat -l -n -p | grep -e openvpn # Runtime configuration pgrep -f -a openvpn ip address show; ip route show; ip rule show; iptables-save ip -6 address show; ip -6 route show; ip -6 rule show; ip6tables-save # Persistent configuration uci show network; uci show firewall; uci show openvpn head -n -0 /etc/openvpn/*.conf
The link below is to a tutorial which was written for the BT Home Hub 5A and Windows Users in mind, but is sufficiently generic to apply to most other OpenWrt routers with a working internet connection. It has been tested with Asus RT-AC57u, Linksys EA6350v3, TPlink Archer C50 v4, Western Digital MyNet N750 etc.
The original v1.1 guide supports LEDE 17 and OpenWrt 18. The later v1.2 guide is for OpenWrt 19.07 using its new ovpn file upload function. Includes information on DNS resolver, Kill switch, and popular VPN providers.
If you are having difficulties getting openvpn client to work using the instructions contained on this wiki page, please download and study the tutorial PDF from the Dropbox folder found in the above ebilan forum page.