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:


curl -OJksS

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

To download and install the latest version of MailArchiva, copy and paste the following command into the terminal, and press enter.


curl -sS | grep -oP '"downloadUrl": *"\K[^"]*' | xargs curl | tar -xz -C /tmp && cd /tmp/mailarchiva_dist* && ./install


Note: As an alternative, links to download the latest version may also be found on the download page


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:


rm -r /tmp/mailarchiva_dist*


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, 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.


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?
© 2005 - 2023 ProProfs

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