DansGuardian Documentation Wiki

You are here: Main Index » where_to_get_it


Wiki Information

This is an old revision of the document!


There are several places to obtain the DansGuardian code, usually including your distribution's repositories.

Make sure you read and agree with the License and Copyright before you download the software. If you are charging for software installation or using this software commercially, then you should pay for a license!

Download Locations

First check the usual repositories for your distribution for a pre-built package. If the usual package for your distribution doesn't meet your version requirements, look for “experimental” or “unofficial” repositories for your distribution.

If you still can't find anything satisfactory, you may be able to download either the source or compiled packages for various operating systems at various places including the following page. (You may instead prefer to use the compiled packages available from the usual archive for your distribution.)

For Patches and Patched versions go to Patches and Hacks. Note currently there are no Patches or Patched Versions for DansGuardian.

Special Distributions

A derivative of DansGuardian is available as the Cop+ addition to the IPCop distribution. (It would be very difficult to install DansGuardian onto an IPCop system directly instead of using the Cop+ package.) That DansGuardian is very closely integrated into IPCop, so much so that configuration information about DansGuardian may be quite difficult to translate for use on an IPCop system. A better source of assistance for Cop+ on IPCop may be http://copfilter.endlich-mail.de/

An unsupported homebrew package derived from DansGuardian is available for SmoothWall Express. A good source for assistance with packages added to SmoothWall Express is http://community.smoothwall.org/forum/

Several of SmoothWall's commercial products inlude a web filter similar to DansGuardian. For assistance with these, contact the reseller you purchased the base product from. Or if you bought directly from SmoothWall, investigate https://support.smoothwall.net/

Building From Source

Sometimes you will need to build from source. Possible reasons for building from source include:

  • desired version not available anywhere as a pre-built package
  • all available pre-built packages used different ./configure options which won't work in your environment
  • you wish to “modify” the source
  • you need an unusual combination of features which isn't readily available
  • you cannot tolerate the usual distribution “lag”, instead you insist on running the “very latest” version (very useful for some other applications, but of limited value with DansGuardian)
  • make it as easy as possible to get help with a problem (seldom really necessary)
  • construct a package that will be included in a Linux distribution
  • construct a package to add to an “unofficial” Linux distribution repository

The complete source code is available as a tarball from the DansGuardian website. Most systems already have almost everything necessary to build DansGuardian from source (glibc, autoconf, gcc, make, etc.). You may need to also obtain: i) the “zlib” build (runtime is probably already there) package and ii) the PCRE build (runtime is probably already there) package.

If you are replacing an existing version (perhaps an earlier one from your distribution), it's important to replicate the exact same build configuration. Do not rely on the “defaults”. The “defaults” cannot encompass the wide variation from one distribution to the next.

To replicate an existing build configuration exactly:

  1. execute dansguardian -v using the old version, capture the exact output in a file, and print it.
  2. in the ./configure step when building the new DansGuardian, enter all the options and values (especially the paths) exactly as they were output by the previous version