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
• Upgrading SmarterMail
• Uninstalling SmarterMail
• Manually Installing SmarterMail
• Things to Know
• Welcome to SmarterMail

Installing SmarterMail on Linux

Run the command below to download SmarterMail from the web and install it on your server:

Run the following in bash 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):

This script 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

To upgrade SmarterMail, first, backup your SmarterMail installation or take a snapshot of your VM.

Run the following in bash to download and run the SmarterMail installer, which will download and upgrade the current SmarterMail build. Replacing the XXXX with the build number you wish to install. Yes, this is the same exact command that you use to install SmarterMail originally.

Uninstalling SmarterMail

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

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:
   wget --timeout=6000 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:
   wget --timeout=6000 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. The last step is cleaning up your downloads, otherwise the next upgrade may fail:
   sudo rm -rf sm-install-data
   rm -f smartermail_*

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 window opens in your default browser that takes you to the web interface for your installation. The URL used will match what was configured during the setup process, and if nothing was changed (e.g., no changes to the hostname or port), your browser will open localhost:9998/interface/setup#/.

On this Welcome page, 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.