Linux Install

››

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 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 update
sudo apt -y install fontconfig

To install Fontconfig on RHEL/Fedora/CentOS machines:

sudo dnf makecache --refresh
sudo dnf -y install fontconfig

Step 2. 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 https://bs.stimulussoft.com/api/v1/download/product/maonprem/linux/latest | grep -oP '"downloadUrl": *"\K[^"]*' | xargs curl | tar -xz -C /tmp && cd /tmp/mailarchiva* && ./install && rm -r /tmp/mailarchiva*

Note: As an alternative, the link to download the latest version may also be found on the download page. After downloading, run ./install to begin setup.

During the installation 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 3. 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 4. 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.

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