Linux Install
The MailArchiva Server can be installed on a variety of Linux distributions. The instructions below illustrate the steps required to install the server on common Linux distributions.
Step 1. Install Haveged (optional, but recommended)
The Haveged utility enhances the entropy available on your server that MailArchiva relies upon to perform various cryptographic operations.
To install Haveged on Debian-based platforms:
sudo apt-get install haveged
sudo update-rc.d haveged defaults
sudo service haveged start
To install Haveged on RHEL/Fedora/CentOS machines:
chkconfig haveged on
To install Haveged on CentOS 8:
curl -OJksS https://dl.fedoraproject.org/pub/epel/epel-release-latest-8.noarch.rpm
yum install epel-release-latest-8.noarch.rpm -yyum install haveged -y
Step 2. Install FontConfig package (needed for PDF font rendering)
MailArchiva relies upon the Linux package FontConfig to render fonts when exporting PDF files. On a clean headless Linux distro install, the FontConfig package may not be available by default.
To install FontConfig on Debian-based platforms:
sudo apt-get update -y
To install Fontconfig on RHEL/Fedora/CentOS machines:
Step 3. Install/upgrade MailArchiva Server
To download and install the latest version of MailArchiva, copy and paste the following command into the terminal, and press enter.
During the install process, when prompted to enter a maximum heap size, refer to Memory Settings for guidance.
Following the above, the server will be installed /opt/mailarchiva. Server binaries are located at /opt/mailarchiva/server. Refer to File System Layout for other locations of interest.
After installation, clean up the /tmp folder as follows:
Step 4. Check Availability of Port 8090 and Port 8091.
By default, MailArchiva uses port 8090 and port 8091. Before starting the server, ensure that these ports are not being used by another application. You can do this by typing “netstat -vatn” from the console. If port 8090 is in use, edit the file /var/opt/mailarchiva/tomcat/conf/server.xml and change all references from “8090” to the desired port.
Step 5. Start MailArchiva Server
To start the MailArchiva Server from the commandline type:
Now that your server is running, access the setup wizard by entering http://localhost:8090 in a modern web browser. Refer to Maintenance / Handover to familiarize yourself with general maintenance steps.
Found this information useful? Visit mailarchiva.com to learn more about MailArchiva.