NxFilter Tutorial
Tutorial Index

Install NxFilter on Linux
You can run NxFilter on Linux and other Unix like OS. We have deb packages, RPM packages and docker images. You also can install it with .zip file from us.


Ubuntu Linux
We have a .deb package for installing NxFilter on Ubuntu Linux. To install it, after you install Java, download the package using 'wget', and then install it using 'dpkg'. Then start it from the Systemd script bundled with the package.


	sudo apt-get install openjdk-8-jre
	wget http://pub.nxfilter.org/nxfilter-4.3.4.6.deb
	sudo dpkg -i nxfilter-4.3.4.6.deb
	sudo systemctl enable nxfilter
	sudo systemctl start nxfilter

You can view the installation process with the following command.


	tail -f /nxfilter/log/nxfilter.log

On Ubuntu 18, 'systemd-resolved' service uses UDP/53. You have to disable it and set another DNS server for your system before you install NxFilter. To stop and disable it, run the following commands.


	sudo service systemd-resolved stop
	sudo systemctl disable systemd-resolved.service
	sudo rm /etc/resolv.conf
	sudo echo 'nameserver 8.8.8.8' > /etc/resolv.conf

Using RPM
Rob Asher has built an RPM repository for NxFilter and other packages. His RPM packages take care of Java installation and all the dependencies.

To install NxFilter using 'yum' command, install Rob Asher's RPM repository first.


	yum install http://deepwoods.net/repo/deepwoods/deepwoods-release-6-2.noarch.rpm

Then you can install NxFilter using yum command.


	yum install nxfilter
There are other packages as well.


	yum install nxcloud
	yum install nxrelay

Using Docker
Charles Gunzelman has built docker images for NxFilter.

When you run NxFilter as a docker container, use the following commands.


	docker run -dt \
	--name nxfilter \
	-v nxfilter-conf:/nxfilter/conf \
	-v nxfilter-log:/nxfilter/log \
	-v nxfilter-db:/nxfilter/db \
	-p 53:53/udp \
	-p 80:80 \
	-p 443:443 \
	-p 19002-19004:19002-19004 \
	packetworks/nxfilter-base:latest

Using zip
You can install NxFilter on other Linux and Unix like OS using a .zip package from us.

  1. Download nxfilter-x.x.x.x.zip
  2. Extract the zip file into /nxfilter
  3. Go to /nxfilter/bin and run 'chmod +x *.sh'
  4. Run startup.sh with root permission
You can run NxFilter as a daemon with '-d' flag to /nxfilter/bin/startup.sh.


Admin GUI
To access its admin GUI, start your browser. If you install it on 192.168.0.100 type 'http://192.168.0.100/admin' into the address bar of your browser. The initial username and password are 'admin/admin'.