Install

There are many roads to Rome, so follow the best fitting.

Install on a debian system

Thats easy, 'cause i am a debian nerd myself and pre-build packages for you, which can be easily installed and removed.

There are two packages:

Get the packages from the download page, upload them to your machine and run:

dpkg -i decency*.deb

Thats all, you can now continue with the configuration of the Doorman Server and following the configuration of the Detective Server.

Install via Github

Get a clone of Decency like so:

git clone git://github.com/ukautz/decency.git

Build and install

Now you have to build the perl module. It has a lot of dependencies, which you need to install as well. Perl will guide you through this.

Before you begin, make sure you have your build tools installed (gcc, perl headers and so on).

./Build.PL
./Build
./Build test
./Build install

Setup user and directories

Decency uses per default the following directories:

You can either stick with those and create them or find your own spots of convenience.
However, before creating them, you have to add a Decency user and group. Per default, both are called "decency", but you can use whatever you want.

/usr/sbin/adduser --system --group --home /var/spool/decency \
    --gecos "Decency anti spam" \
    --disabled-password --quiet decency

Now create the directories and change ownership to the Decency user and group.

Using local::lib for perl packages

Decency tries to use local::lib by default.

Using install dir for additional perl packages

Decency is looking in the following directories for perl modules:

To install perl modules into a certain directory, you can use this script like so (make it executable beforehand):

./perl-install-dir.sh /opt/decency/locallib Archive::Tar Cache::FastMMap MongoDB

Setup config

Copy all configuration files from the unpack dir conf/ folder into your Decency configuration directory (default: /etc/decency) and read on configuration of the Doorman Server and following configuration of the Detective Server.

Install via CPAN

Warning: The CPAN packages are way!! out of date! Do not use them, until they are updated.

Basically the same as with github, but here you start with:

perl -MCPAN -e 'CPAN::install( "Mail::Decency" )'

Now proceed with "Setup user and directories" from above.