How To: Dansguardian Web Content Filter w/GUI (my version)

[mhancoc7]

There are now two flavors of the dansguardian w/gui scripts. One for Dapper and one for Edgy. You can download them from their respective download pages using the link below.

www.mirror.christianubuntu.com

Thanks, Jereme

The info below is only for historical purposes.

I have built a script to install Dansguardian web content filtering with a GUI that allows you to easily edit the filter settings. This is a modified script that I use for the building of Ubuntu Christian Edition as well as in the scripts to "convert" to Ubuntu Christian Edition. I figured there are probably some people who do not want Ubuntu Christian Edition, but do want Dansguardian web content filtering with a GUI.

First let me thank those who inspired and guided this script through their work and posts.

nanomad: http://www.ubuntuforums.org/showthre...nsguardian+gui
tonhou: http://www.ubuntuforums.org/showthread.php?t=207008&highlight=setup+dansguardi an

Instructions:

Packages Installed:
Dansguardian Web Content Filtering (dansguardian, tinyproxy, clamav, firehol)
Graphical tool to easily change the Dansguardian filter settings (gambas, libqt3-mt)

How to run the script:
1. Download the attached script archive to your Home directory.
2. Right click on the archive and select Extract Here.
3. Open a terminal window (Applications > Accessories > Terminal).
4. Type the following then hit Enter:
cd /home/YOURUSERNAME/install_dansguardian_gui
5. Type the following then hit Enter:
sudo ./install_me
6. Type your password then hit Enter.

Once you have finished running the script immediately reboot your computer. Dansguardian WILL NOT function correctly until after you reboot. Your original sources.list file will be restored when the script is finished.

*Note: This is a powerful script. It will be making changes to your system and should be USED AT YOUR OWN RISK!!

**Note: This script has only been tested on a fresh install of Ubuntu 6.06 Dapper. Results may vary with other flavors of Ubuntu or different configurations.

***Note: You may want to make backup copies of the following files:
/etc/apt/sources.list

****Note: You may see a few errors during the script regarding dansguardian and clamav. These should be ignored. Once you reboot your computer these configuration issues will be resolved.

*****Note: This script is somewhat disposable. If you need to run the script a second time you will need to extract it from the original archive.

After you reboot you will have Dansguardian web content filtering working in all browsers. You can modify the filter settings using the GUI. The GUI is located at System > Administration > Configure Parental Controls. After making any changes be sure to save the file in gedit and click "Save & Exit" on the GUI.

I hope you all enjoy.

Jereme

[tonhou]

Thanks Jereme.

It seems to install very well. Incidentally I have successfully set it up on Xubuntu and everything works fine (adds menu entries also).

Well done!

--Tony

[mhancoc7]

Thanks Jereme.

It seems to install very well. Incidentally I have successfully set it up on Xubuntu and everything works fine (adds menu entries also).

Well done!

--Tony

Thanks Tony,
I am glad that it is working. I always test a lot before I release something, but I always worry. I hope you enjoy.
Jereme

[tonhou]

Further to above comment about the script installing successfully:

Xubuntu : also requires that gedit be installed to enable the gui to work for changing the filters.

Kubuntu : everything installs and works fine but note these:
1. At install there are many error messages that are not critical.
2. For functioning of the filter changing gui then you must again install gedit which pulls in a number of gnome libraries (approx 7Mb download) and must also install gksu which is needed for password entry.

Edubuntu : have yet to try the script here but don't expect there to be any problems.

--Tony

[mhancoc7]

Further to above comment about the script installing successfully:

Xubuntu : also requires that gedit be installed to enable the gui to work for changing the filters.

Kubuntu : everything installs and works fine but note these:
1. At install there are many error messages that are not critical.
2. For functioning of the filter changing gui then you must again install gedit which pulls in a number of gnome libraries (approx 7Mb download) and must also install gksu which is needed for password entry.

Edubuntu : have yet to try the script here but don't expect there to be any problems.

--Tony

Thanks for posting your results. I built the script for the default Ubuntu. It is nice to see what happens in the other flavors.
Jereme

[Mithrilhall]

Ok...I just installed this on Kubuntu (Dapper).

Here is my setup.

Router <-----> Kubuntu (Dansguardian) <----> Switch <----> Computers


I can no longer pull an IP from the router through my Kubuntu box. I have bridged my eth0 & eth1 and it was working fine before running the script.

Is there anything I need to adjust?

[jbeiter]

Thank you VERY MUCH for this! thankyouthankyouthankyou!

[calvinthomas]

Excellent, really good! Thankyou very much, I don't know if this is relevant but it is working perfectly for me in an XGL session.

A question: Is it possible to allow certain website extensions? Like i'd like to allow all .edu and all .ac.uk sites? Can I do this?

A tip: Putting education into the allowed phrases list makes accessing things like sex education etc accessible and from a basic internet search doesn't allow any unwanted things through.

Calv

[mhancoc7]

Excellent, really good! Thankyou very much, I don't know if this is relevant but it is working perfectly for me in an XGL session.

A question: Is it possible to allow certain website extensions? Like i'd like to allow all .edu and all .ac.uk sites? Can I do this?

A tip: Putting education into the allowed phrases list makes accessing things like sex education etc accessible and from a basic internet search doesn't allow any unwanted things through.

Calv

I am glad to hear you that it is working for you. I am not sure about allow certain web extensions. You may want to check at the Dansguardian site (www.dansguardian.org). Let me know what you find.
Jereme

[calvinthomas]

Ok after editing things, i've messed it up and its not filtering at all any more! I tryed reinstalling the script but that hasn't helped, is there any way to completely remove this so I can reinstall it from scratch? The problem I think is this, from a terminal:

calvin@calvin-laptop:~$ dansguardian
Error opening /etc/dansguardian/dansguardian.conf

Help much appreciated!

Calv