Installation

Revision as of 12:34, 16 April 2021 by Ltalaschus (talk | contribs) (→‎Completing the MailStore Server Setup Wizard)
(diff) ← Older revision | Latest revision (diff) | Newer revision → (diff)

MailStore Server can be installed on virtually any Windows PC. Neither a server operating system nor a database system is required. For example, you can set up a test installation of MailStore Server on your desktop machine without any problem. Running MailStore Server inside a virtual machine is supported as well. For more information, please refer to the System Requirements article.

Choosing a Computer for the Installation of MailStore Server

Whenever possible, MailStore Server should be installed on a dedicated machine. Depending on the environment, archiving strategy and usage, MailStore Server can be installed on an already existing server, too. On the part of the email server to be archived, no components need to be installed though.

Starting the Installation

To start the installation process, double-click on the downloaded setup file. This is a regular Windows installation, just follow the instructions on the screen:

  • If you want to install MailStore Server in a language different to the operating system's, you can choose it at the beginning of the installation.
  • Carefully read the license agreement and privacy policy. You have to agree to these terms to continue.
  • In the next step you can choose which folder to install MailStore Server in. In most cases, you should keep the default setting.
  • The installation program now deploys the necessary components.

Install License

  • Setup003.png
    You must now enter your MailStore product key which you have received by email after your trial registration or upon buying MailStore Server. Alternatively you can import a license file here. That file you can download either through the link provided in the dialog or directly from our website.
  • If you've entered a valid 30-day-trial key, it will be activated automatically. If you've entered a production license key, all information that is sent to MailStore will be displayed before activation.


Configure Certificate

  • In the next step, you need to configure the certificate to be used by MailStore Server in order to ensure authenticity and security for all inbound connections. The certificate can be changed any time after the installation through the MailStore Server Service Configuration tool.
    • Create self-signed certificate
      Setup003a.png

      Though not recommended for production use, self-signed certificates may be a good choice for a trial installation. But keep in mind that self-signed certificates will trigger certificate warning in web browsers and email clients.
    • Use existing certificate
      If a certificate from a trusted Certificate Authority already exists (i.e. a wildcard certificate for your domain), this is the best option to select.
    • Obtain certificate from Let's Encrypt
      Select this option if you would like to obtain a certificate from the free Certificate Authority Let's Encrypt


Option 1: Create Self-Signed Certificate

  • Setup003a1.png
    To create a self-signed certificate, that matches the actual server name, enter the name (i.e. mailstore.example.com) into the corresponding field Server Name. This server name should be resolvable by your client computer.


Option 2: Use Existing Certificate

  • Setup003b1.png
    Click on the ellipses choose from:
    • Select from Certificate Store...
      Use an existing certificate from the computer's certificate store.
    • Import from File...
      Import a certificate from a file into the computer's certificate store.


Option 3: Obtain Certificate from Let's Encrypt

  • Setup003c1.png
    This page lists the prerequisites for obtaining a certificate from Let's Encrypt, which are:
    • A public DNS record (A or CNAME) for this server must exist and point to its public IP address.
    • The server must be accessible from the Internet on TCP port 80 (HTTP) for Let's Encrypt's automatic domain approval process. A port forwarding on your firewall or gateway may be necessary.
  • Further information are available in Using Lets Encrypt Certificates.


  • Setup003c2.png
    To obtain a certificate from Let's encrypt an email address and the server name for which the certificate is requested must be entered in the corresponding fields.
  • Check the I accept Let's Encrypt's Subscriber Agreement box after you have read Let's Encrypt's Subscriber Agreement by clicking on the corresponding link.


Completing the MailStore Server Setup Wizard

  • In the next step you can configure several settings of your MailStore Server installation:
    • Setup004.png
      Auto-configure Windows Firewall
      If this option is enabled, the default MailStore TCP ports will be opened in the Windows Firewall by the installation program automatically.
    • Automatic license update
      If this option is enabled, MailStore Server regularly checks for updated license data. If a new license is available, e.g. more users have been licensed or the Update and Support Service contract has been extended, it will be downloaded and applied automatically.
    • Enable automatic update check for server
      If this option is enabled, MailStore Server regularly checks for new product versions. If a new version is available, this will be displayed on the dashboard in the MailStore Client.
    • Enable automatic update check for Web Access
      If this option is enabled, MailStore Server regularly checks for new versions of the MailStore Web Access. If a new version is available, this will be displayed on the dashboard in the MailStore Client.
    • Automatically install updates
      If this option is enabled, new versions of MailStore Web Access will be downloaded and installed automatically without having to restart the MailStore Server Service.

Help us to improve MailStore

  • At the end of the installation process you can opt to help us improving MailStore:
    • Setup005.png
      Submission of anonymous usage data
      If this option is enabled, MailStore Server regularly sends data on how the program is being used to MailStore. This data allows us to better understand different usage scenarios of MailStore Server and focus our development capacities accordingly. The submitted data is collected and evaluated exclusively for this purpose.
      No personal data such as user names, passwords or email content will be submitted. The submitted data is completely anonymized and cannot be correlated to a specific customer installation. You can enable or disable this option in the MailStore Client under Administrative Tools > Miscellaneous > Product Updates at any time; the option is disabled by default (opt-in).
  • By clicking on Finish the installation will be completed and the MailStore Server Service and the MailStore Client will be started.

Customizing the Installation

The installation program creates a fully functional default installation of MailStore Server, which is perfectly suited for testing purposes. For production environments, parameters such as the Master Database directory, features, TCP ports, SSL certificates etc can be customized via the MailStore Server Service Configuration.

First Time Installation

After successfully installing MailStore Server for the first time, it is recommended to continue with the Quick Start Guide. A step-by-step tutorial explains the basics, from creating users to successfully archivig emails for the first time.