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:


yum install haveged
chkconfig haveged on


To install Haveged on CentOS 8:


Yum install wget -y
yum install epel-release-latest-8.noarch.rpm -y
yum 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 install -y fontconfig-config
sudo apt-get update -y


To install Fontconfig on RHEL/Fedora/CentOS machines:


sudo yum install fontconfig


Step 3. Install/Upgrade MailArchiva Server

Download the latest MailArchiva distribution. To install the server, type the following:


tar –xvzf mailarchiva_server_linux_v8.11.30.tar.gz
cd mailarchiva_dist_v8.11.30


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.


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:


sudo systemctl start mailarchiva


Now that your server is running, refer to Maintenance / Handover to familiarize yourself with general maintenance steps.


Alternative start:  If your Linux distribution doesn't support Systemd services, or the above start service command simply doesn't work on your system, MailArchiva can also be started directly by running /opt/mailarchiva/server/startserver and stopped by running /opt/mailarchiva/server/stopserver.
Was this information helpful?

Found this information useful? Visit to learn more about MailArchiva.

The page cannot be found

The page you are looking for might have been removed, had its name changed, or is temporarily unavailable. Please make sure you spelled the page name correctly or use the search box.