Running NxFilter on a headless Raspberry Pi

NxFilter is the best free solution for a self-hosted DNS server/filter I have found so far. Today I got my Raspberry Pi, so how about running NxFilter on a headless Raspberry Pi in a family’s home network?

Note: This article is based on a Raspberry Pi Model 2B and NxFilter Version 3.5.1. Never versions of either product may behave differently.


The current Desktop version of Raspbian, the default Debian-based Operating System for the Raspberry Pi already comes with all required packages (Java, unzip, wget)

  1. Install Raspbian on the Raspberry Pi. You can do this also headless, without an attached Keyboard and Screen, for example by following the official guide on how to install an Operating System on an SD card,  or this more generic guide for a fully automated, configured installation.
  2. Enable SSH
  3. Connect to your Raspberry via SSH, using the default (or configured) Username/Password.
  4. Optional: Update Raspbian to the latest version.
  5. Recommended: Change the default password.
  6. If you used the lite version of Raspian, you need to install JAVA.

Installing NxFilter

Note: This guide roughly follows the  the unix installation instructions from the NxFilter manual:

  1. Download the latest version of NxFilter with wget
  2. Unzip to the installation folder (requires root-access)
    sudo unzip -d /nxfilter
  3. Change to the installation folder
    cd /nxfilter/bin
  4. Make the necessary scripts executable
    sudo chmod +x *.sh

Manual Startup

  1. Run
    sudo ./

Automatic Startup at each Raspberry boot

  1. Add the line /nxfilter/bin/ -d near the end of the file /etc/rc.local
    cd /etc
    sudo nano rc.local
  2. After doing so, the end of the file should look something like
    # NxFilter Autostart
    /nxfilter/bin/ -d
    exit 0
  3. Reboot
    sudo reboot

Configuration of NxFilter

  1. Using another machine with a browser, navigate to http://youripaddress/admin Default Username and Password is admin/admin.
  2. Change default password via “Config/Admin”
  3. See the manual for all configuration options.