Home » Networking » OpenWrt » Openwrt Openvpn Luci

Configuring a Privacy VPN with OpenVPN on OpenWrt With LuCI

This tutorial will show you how to configure a privacy Vpn using OpenVPN on OpenWrt through the LuCI web interface (no command line required!). Lots of screenshots are included so that you can follow along.

What is OpenWrt

OpenWrt is a popular Linux distribution for routers and other low power devices. It makes a perfect host for a VPN gateway.

What is a Privacy VPN/ What is OpenVPN?

VPN (Virtual Private Network) provides an encrypted connection between two networks over the internet.

Traditionally this was used for connecting remote business networks (eg. two offices in different states), but now it is more popular as a privacy tool – allowing you to route your internet traffic to another location so that your internet activity is more difficult for advertisers to track.

There are many privacy VPN products, and most of them support OpenVPN, an open source VPN server and client.

How to Set up OpenVPN on OpenWrt

Here’s how to configure OpenVpn on OpenWrt with the LuCI GUI Web interface.

Obtain an OpenVPN Configuration File

Your VPN provider will provide you with configuration files in the .ovpn format – you simply need to locate and download them from your VPN providers website.

I can’t be much more specific than that – the steps will depend on which VPN product you are subscribed to!

Install OpenVPN software on OpenWrt

Below are the steps for installing and configuring OpenVPN.

To get started, navigate to:


…and click Update Lists to get a list of installable software.

openwrt openvpn luci 1

Type ‘openvpn’ into the Filter box and then click the Install button next to the following packages:


You’ll see a list of dependencies and an install button for each package, confirm each by clicking Install:

openwrt openvpn luci 2

Configure OpenVPN

Navigate to:


openwrt openvpn luci 7

Browse for the .ovpn configuration file provided by your VPN service and give it a name. Click Upload to save the configuration file under that name.

openwrt openvpn luci 8

The uploaded configuration will now appear in the list – click Edit to edit the configuration, we need to make a few tweaks.

openwrt openvpn luci 9

Change the dev entry from tun to tun0.

openwrt openvpn luci 10

Then, scroll down to the auth-user-pass entry and append the path to the optiona; auth-user-pass file which is printed below.

Fill a username and password in the lower box to complete this step if user authentication is required for your VPN provider.

Click the Save button when you’re done. And then navigate back to the OpenVPN configuration screen.

openwrt openvpn luci 11

Enable the new VPN configuration buy checking the Enable checkbox.

Click Save and Apply when you’re ready to continue.

Configure Network Interface

Navigate to:


openwrt openvpn luci 14 1

Click on Add new interface.

openwrt openvpn luci 15 1

Fill out the Add new interface form as shown in the highlighted areas. I’ve named this interface VPN0. You will need to type in the interface name – it does not yet exist in the list.

openwrt openvpn luci 16 1

Here’s how the Add new interface form should look. Save it by clicking Create interface.

openwrt openvpn luci 17 2

Click Dismiss after confirming the details of the created interface.

openwrt openvpn luci 18 1

The VPN0 interface will now appear in the interface list.

Configuring the Firewall

Navigate to:


openwrt openvpn luci 19

Click on the Add button under Zones.

openwrt openvpn luci 20

Fill out the settings for the new zone to match the above screenshot. I’ve simply named this zone vpn.

Click Save to return to the zones list and then edit the lan zone. By default, the lan zone will by default allow forwarding to the wan zone.

We will replace this with the vpn zone instead, replacing the internet connection provided by the wan network with the vpn network.

openwrt openvpn luci 21

Set the lan zone form to match the above and save.

openwrt openvpn luci 22

Your firewall screen should now look something like this – lan should forward to vpn.

Click Save & Apply to continue.

Configure DNS

Navigate to:

Network->DHCP and DNS

openwrt openvpn luci 23

Update the address for DNS Fowardings. This should be the IP address of a DNS server provided by your VPN service so that all traffic, including DNS lookups, is contained within the VPN.

If your VPN provider doesn’t provide a DNS server, CloudFlare’s DNS server can be used, but your traffic may not be fully hidden from your ISP.

Next, click on the Resolv and host Files tab.

openwrt openvpn luci 24

Check the Ignore resolve file box. Save & Apply to continue.

Reboot OpenWrt

Navigate to:


openwrt openvpn luci 26

Press the Perform reboot button to reboot the system, so we can be sure all changers are properly applied.

Testing OpenVPN Connection on OpenWrt

Navigate to:


…and run an IPv4 Traceroute.

openwrt openvpn luci 27 1

You’ll see the first hop – this is not a public IP address – it’s the IP address of the VPN gateway, confirming the connection is working and that traffic is being correctly routed.

openwrt openvpn luci 28 1

If I check my IP address online, I can also see that it has changed from my regular IP address (as has the location).

Everything seems to be working correctly!

Troubleshooting OpenVPN on OpenWrt

Sometimes things don’t quite work out, and the OpenVPN LuCI app doesn’t really tell you much if something goes wrong – in fact, it doesn’t even tell you something’s wrong at all.

If your connection isn’t working, head to

Status->System log 

And scroll to the bottom – as OpenVPN retries the connection it will be outputting messages which describe any problems it is encountering.

Photo of author
I'm Brad, and I'm nearing 20 years of experience with Linux. I've worked in just about every IT role there is before taking the leap into software development. Currently, I'm building desktop and web-based solutions with NodeJS and PHP hosted on Linux infrastructure. Visit my blog or find me on Twitter to see what I'm up to.

Leave a Comment