Community Knowledge Base

Installation and Upgrade (Linux)

SmarterMail comes as a single installation file that will automatically download and install the appropriate operating system components required to run SmarterMail on your server. The features available are based on the license used during the activation process; if no license is entered, the Free Version will be installed.

Jump to:

Installing SmarterMail on Linux

SmarterMail’s Linux installers depend on both curl and libicu packages. Most distributions include these by default, but if yours doesn’t, run the following commands before installing.

CentOS Stream:

yum install curl libicu

Debian 11:

apt install curl libicu67

Debian 12:

apt install curl libicu72

Debian 13:

apt install curl libicu76

Fedora:

dnf install curl libicu

Red Hat:

yum install curl libicu

Alma Linux:

yum install curl libicu

Rocky Linux:

yum install curl libicu

Suse Enterprise:

zypper install curl libicu

Ubuntu 20:

apt install curl libicu66

Ubuntu 22.04:

apt install curl libicu70

Ubuntu 22.10:

apt install curl libicu71

Ubuntu 23:

apt install curl libicu72

Ubuntu 24:

apt install curl libicu74

Ubuntu 25:

apt install curl libicu74

After installing both curl and libicu packages, run the following in bash command to download and run the SmarterMail installer, which will download and install the current SmarterMail build. Replace the XXXX with the build number you wish to install (a full list of versions is available on the SmarterMail Release Notes page):

curl -O https://downloads.smartertools.com/smartermail/100.0.XXXX/smartermail_XXXX \
&& sudo chmod +x smartermail_XXXX \
&& sudo ./smartermail_XXXX install

This bash command will download and run the SmarterMail installer. This includes setting up all folders and directories needed to run SmarterMail. Therefore, it's just like any standard program installation.

Upgrading SmarterMail

Before upgrading, back up your SmarterMail data or take a snapshot of your VM.

To upgrade, run the same command you used to install SmarterMail, replacing XXXX with the build number you want to install:

curl -O https://downloads.smartertools.com/smartermail/100.0.XXXX/smartermail_XXXX \
&& sudo chmod +x smartermail_XXXX \
&& sudo ./smartermail_XXXX install

The installer finds your existing installation and asks you to confirm the update. It then stops the SmarterMail service, replaces the program files in /opt/smartermail and starts the service again. Your data in /var/lib/smartermail and your system configuration in /etc/smartermail aren't touched, so you don't need to stop the service or uninstall SmarterMail first. If the build you chose is already installed, the installer exits without making changes.

The installer also asks again whether you want to use SmarterMail's built-in web server. Give the same answer you gave when you first installed SmarterMail: choose Yes if SmarterMail serves its web interface directly, or No if it runs behind NGINX, Caddy, Apache or another reverse proxy.

To roll back, run the installer for an older build. The confirmation prompt will ask whether you want to downgrade before it makes any changes.

Upgrading without prompts

To upgrade from a script, add the following options to the install command:

  • --no-prompts skips the confirmation and web server prompts. If the End User License Agreement hasn't been accepted on this server yet, this option also accepts it.
  • --webserver sets the web server answer. Use smartermail for the built-in web server or none if SmarterMail runs behind another web server or reverse proxy. If you use --no-prompts without this option, the installer sets up the built-in web server, so servers behind a reverse proxy should always include --webserver none.
sudo ./smartermail_XXXX install --no-prompts --webserver none

Uninstalling SmarterMail

To uninstall SmarterMail, run the following in bash command, in the folder where you downloaded the SmarterMail installer. If you do not have the installer still, you can download it again using the curl and chmod commands in the installation section above.

sudo ./smartermail_XXXX uninstall

Manually Installing SmarterMail

To manually install SmarterMail — generally when automating the installation process or installing via scripts — do the following:

  1. First, you want to download the installer:
    curl --max-time 6000 -O https://downloads.smartertools.com/smartermail/100.0.XXXX/smartermail_XXXX
  2. Next, download the ZIP package, which contains all of the files necessary to install SmarterMail:
    curl --max-time 6000 -O https://downloads.smartertools.com/smartermail/100.0.XXXX/smartermail_XXXX.zip
  3. Create a folder called "sm-install-data"
    mkdir sm-install-data
  4. Then, you'll want to move and rename the ZIP file you downloaded to that new folder:
    mv smartermail_XXXX.zip sm-install-data/sm.zip
  5. Now you can run the installer:
    sudo ./smartermail_XXXX install
  6. Clean up your downloads. If the sm-install-data folder is left next to the installer, a later install or upgrade uses the files in it, even if they're from an older build:
    sudo rm -rf sm-install-data
    rm -f smartermail_*

That should do it. SmarterMail is installed and ready for any future upgrade/update.

Things to Know

By default, files are stored in the following locations:

  • System Configuration Files - /etc/smartermail
  • SmarterMail Data Files - /var/lib/smartermail

Additionally:

  • The Release Notes for all major and minor versions of SmarterMail, as well as Release Notes for all current Builds, are available on the SmarterMail Release Notes page of our website. It's a great idea to familiarize yourself with all the changes that have been made to SmarterMail between the version you're on and the version you'll BE on once you've upgraded.
  • If you are upgrading an installation that utilizes a license key, you WILL need to re-activate that key once the upgrade completes. Please be aware that license keys pertain to the version of SmarterMail you're running as well as the maximum version of SmarterMail you CAN run — you cannot activate a key on a more recent version of SmarterMail if your key does not support that version. However, all license keys are retroactive for previous versions.

Welcome to SmarterMail

After SmarterMail is installed, a bash confirmation message will appear: "SmarterMail is now running. Installation complete!" This confirms the installation was successful.

The first thing you'll do is select which version of SmarterMail you want to install: Professional or Enterprise or SmarterMail High Availability.

  • SmarterMail Professional or Enterprise - This is the typical, single server installation of SmarterMail.
  • SmarterMail High Availability - This is the installation process for installing a node (either the first node or subsequent nodes) that resides in a SmarterMail High Availability cluster. SmarterMail High Availability requires a partnership with SmarterTools. For more information, contact sales@smartertools.com.

After selecting your installation type, you'll set up a few pieces of information to get started using SmarterMail:

  • You'll create the primary system administrator account
  • You'll set the default base path for storing all SmarterMail data. This includes domain data, spool, log files, and POP and IMAP retrieval data, etc. By default, this path is /var/lib/smartermail

Once you have set up this information, you will be redirected to the webmail interface and automatically logged in to SmarterMail using the system administrator you created. From there, you can add in your first domain, then add users to that domain, you can modify your default domain template, adjust the security settings as needed, and more.