Skip to main content

OpenWRT Filtering Module Setup

The SafeDNS module for OpenWRT routers allows setting up the filtering on any router that supports OpenWRT firmware. Every end device on the network can be assigned with individual filtering settings.

Only OpenWRT version 21, and versions 17 or lower are supported.

If you are installing version 21, make sure to read the Uninstallation notes at the bottom

OpenWRT versions 17 and lower

OpenWRT versions 17 and lower

To make sure that your router has OpenWRT firmware, check the list of compatible OpenWRT routers.

1. Log in to the web interface of the router as administrator.

1.OpenWRT Filtering Module Setup Guide.png

2. Go to System > Software

2.OpenWRT Filtering Module Setup Guide.png

3. Choose the Configuration tab3.OpenWRT Filtering Module Setup Guide.png

4. Comment or remove the line option check_signature 1 to disable packet signature verification.

4.OpenWRT Filtering Module Setup Guide.png

5. Add line

src/gz safedns http://mirror.safedns.com/openwrt/17/ar71xx/generic/packages

to the field "Custom feeds", as shown in the screenshot, where "ar71xx" – is your router architecture type. If you have another architecture please change it to the correct one:

5.OpenWRT Filtering Module Setup Guide.png

6. Go to the Actions tab and click "Update lists"

6.OpenWRT Filtering Module Setup Guide.png

Wait for the update process to finish.

7. Find the "safedns" package in the filter and click "install"

7.OpenWRT Filtering Module Setup Guide.png

8. Refresh the page after this.

8.OpenWRT Filtering Module Setup Guide.png

9. Go to Services > SafeDNS

9.OpenWRT Filtering Module Setup Guide.png

10. Enter your SafeDNS credentials and log in to get the list of available filtering policies. In the "Default profile" field choose the filtering policy which will be applied as a default for all of your devices connected to the router.

10.OpenWRT Filtering Module Setup Guide.png

11. You can also set a specific filtering policy for any device. To do this, click Add, choose the device, and select the filtering policy. Save the settings.

11.OpenWRT Filtering Module Setup Guide.png

After that, you can continue configuring your filtering options in the SafeDNS Dashboard.

OpenWRT version 21

1. Log in to the web interface of the router as administrator.

Screenshot_5.png

2. Go to System > Software

Screenshot_6.png

3. Press the Configure opkg... button

Screenshot_7.png

4. Comment or remove the line option check_signature 1 to disable packet signature verification.

Screenshot_8.png

5. Add line

src/gz safedns http://mirror.safedns.com/openwrt/21/YOUR_ROUTER_ARCHITECTURE/custom

to the field "Custom feeds", as shown in the screenshot, where "YOUR_ROUTER_ARCHITECTURE" – is your router architecture type. If you have another architecture please change it to the correct one:

Screenshot_10.png

6. Go to the previous menu and press "Update lists"

Screenshot_9.png

Wait for the update process to finish.

7. Find the "luci-compat" package in the filter and click "install"

Screenshot_17.png

8. Find the "luci-app-safedns" package in the filter and click "install"

Screenshot_18.png

Refresh the page.

9. Go to Services > SafeDNS

Screenshot_13.png

10. Enter your SafeDNS credentials and log in to get the list of available filtering policies. In the "Default profile" field choose the filtering policy which will be applied as a default for all of your devices connected to the router.

Screenshot_14.png

11. You can also set a specific filtering policy for any device. To do this, click Add, choose the device, and select the filtering policy. Save the settings.

Screenshot_15.png

After that, you can continue configuring your filtering options in the SafeDNS Dashboard.

Version 21 uninstallation notes

This version of the module contains a bug, that doesn't set the DNS server port to the default value. You need to do it manually, otherwise, the Internet connection will not work.

1. Navigate to Network > DHCP and DNS > Advanced settings.

Screenshot_19.png

2. Scroll down to the DNS server port field and delete the "0". Leave the field empty and press the "Save & Apply" button.

Screenshot_20.png

Please note that settings take 5-7 minutes to apply.
Stats and filtering status update every 10 minutes.

Back to top