[edit] Installing Bongo

[edit] Stage One - Pre-Installation Checklist

Some things to think about before you install Bongo

• Is this a production server? Bongo is still very much in development and you will encounter some issues!

[edit] Stage Two - Installing Bongo for Your Distribution

At the moment, there are several guides floating about on the wiki for getting Bongo installed. You can find

• Directions from Source
• Debian- etch
• Ubuntu - Fesity Fawn 7.40
• Fedora - Core 6, 7 and 8
• CentOS and RHEL - Versions 4 and 5
• Mandriva - 2007
• openSUSE - SUSE 10.1, openSUSE 10.2, openSUSE 10.3, Factory 11 and Enterprise 10
• Gentoo
• rPath

[edit] Stage Two - Web Server Setup

Bongo has two web interfaces - Dragonfly and Hawkeye. Dragonfly is the user front-end for Bongo and Hawkeye is the administration interface to configuring Bongo. Currently you will still have to use the bongo-config command for some functionality (e.g. adding users, changing passwords). As with most things in Bongo, you have several options on how you want to run your webserver

• Standalone - Bongo comes with a built-in webserver that will work straight off the bat. You can access Dragonfly at http://yourservername:8080/dragonfly.html and Hawkeye from http://yourservername:8080/admin/login/>. No extra worked required!
• Apache - Ideal if you already have Apache and want to integrate Bongo with your current setup.
• lighthttpd

[edit] Configuring Bongo

[edit] Adding Users

Eventually, you will be able to use Hawkeye to add users but currently, you need to drop to the command line and use bongo-config to add and remove users. To add a new user called purple, run

 bongo-config user add purple
 bongo-config user password purple

Simple as that! This will add a new user and allow you to enter a password for them.

[edit] Anti-Virus Protection

Bongo comes with support for ClamAV, a free and rather good anti-virus solution. With the current source, all that is required is to install ClamAV with your respective package management system. On various distributions, the packages needed are

• Debian and Ubuntu - clamav
• Fedora - clamav

Once clamav is installed, you will need to configure it. On Debian/Ubuntu you can run the command

 dpkg-reconfigure clamav-base

You can accept all the standard settings except you want TCP and not Unix for the connection type and it needs to run on port 3310. You can then stop and restart ClamAV with the command

 sudo /etc/init.d/clamav-daemon restart

[edit] Anti-Spam Protection

As with Anti-Virus, Bongo comes with built in support for SpamAssassin, an award winning system used by most internet providers tp keep their users spam free. To install, you need the respective packages for your distribution

• Debian and Ubuntu - spamassassin
• Fedora - spamassassin

You now to edit a text file to actually enable SpamAssassin. Open up /etc/default/spamassassin in your favourite editor. Changed ENABLED=0 to ENABLED=1 and CRON=0 to CRON=1. This will ensure SpamAssassin is started on system boot and that a cron job is run every day to keep it up to date.