Set the Hostname

Before you begin installing and configuring the components described in this guide, please make sure you’ve followed our instructions for setting your hostname. Issue the following commands to make sure it is set properly:

1
2

hostname
hostname -f

The first command should show your short hostname, and the second should show your fully qualified domain name (FQDN).

Install Citadel

Issue the following commands to install any outstanding package updates:

1
2

apt-get update
apt-get upgrade

Issue the following commands to install the citadel-suite, spamassassin and amavisd-new packages:

1

apt-get install citadel-suite spamassassin amavisd-new

The installation process will prompt you for several configuration items. Recommended answers for these prompts are as follows.

Please note: The HTTP and HTTPS port options are particularly important. If you have already installed a web server package such as Apache or nginx that will use ports 80 and 443, please do not specify these ports for your Citadel installation.

Listen address - 0.0.0.0

Authentication method - Internal

Citadel administrator username - admin

Integration with Apache webservers - Internal

Webcit HTTP port - 80 if you are not running another web server, 8080 otherwise

Webcit HTTPS port - 443 if you are not running another web server, 4343 otherwise

If you need to reconfigure any of these options later, you can use the following command:

1

/usr/lib/citadel-server/setup

Check the file /etc/default/webcit to make sure the installer correctly set your desired HTTP and HTTPS ports. You may need to update the following lines:

Commercial Certificate Instructions

As part of this process, you will be prompted to enter several values, as shown below. Please take special care to specify your server’s fully qualified domain name for the “Common Name” setting.

1
2
3
4
5
6
7
8
9
10
11

Country Name (2 letter code) [AU]:US
State or Province Name (full name) [Some-State]:New Jersey
Locality Name (eg, city) []:Galloway
Organization Name (eg, company) [Internet Widgits Pty Ltd]:Example Org
Organizational Unit Name (eg, section) []:Network Services
Common Name (eg, YOUR name) []:hostname.example.com
Email Address []:support@example.com
Please enter the following 'extra' attributes
to be sent with your certificate request
A challenge password []:
An optional company name []:

Submit the citadel.csr file to your SSL certificate provider for signing. They will send you a signed certificate file; save it as /etc/ssl/citadel/citadel.cer. Once this has been done, issue the following command to copy the required files to the webcit directory:

1

cp -a citadel* /etc/ssl/webcit/

Self-Signed Certificate Instructions

Issue the following commands to generate a key and certificate signing request.

Running Citadel

Customize the logon banner for your Citadel server by editing the /etc/citadel/messages/hello file:

/etc/citadel/messages/hello

1
2
3

Welcome to ^humannode!
This logon banner resides in ^bbsdir/hello -- please customize it for your site.

Issue the following commands to initialize Citadel.

1
2

/etc/init.d/citadel restart
/etc/init.d/webcit start

Visit the web interface in your web browser. Using our preceding example, the Web address to visit would resemble the following URL (append “:4343” if necessary):

1

https://hostname.example.com

At this point, your email system should be fully functional and can be configured through the web interface. To finish enabling SpamAssassin support, select “Administration” in the control panel. Next, click “Domain names and Internet mail configuration”. Enter “127.0.0.1” in the box for the SpamAssassin host.

Lost Password Recovery

If you lose the password to your administrator account, issue the following command:

1

/usr/lib/citadel-server/setup

When prompted for administrative account information, specify a new username and password. You may accept all other default settings. You should be able to log in as the new admin user. You may then reset the password for your original administrator account. After this is done, log back in as the original administrator and delete the temporary admin account.

More Information

You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.