MailStore Gateway Help - User contributions [en]

System Requirements

2026-02-23T13:47:41Z

Cstelzmann:

__NOTOC__
Before beginning the installation of MailStore Gateway, all system requirements must be met.

== Hardware Requirements ==
{| class="wikitable" width="100%"
! width="150" scope="row" | '''Processor'''
| Any x64 compatible CPU
|-
! width="150" scope="row" | '''Main Memory'''
| 512 MB
|-
! width="150" scope="row" | '''Hard Disk'''
| 150 MB available disk space + enough disk space to store expected email volume.
|-
! width="150" scope="row" | '''Network Bandwidth'''
| 100 MBit/s
|}

Important Notice: When using in conjunction with MailStore SPE use a separate system with Enterprise SSD Storage for MailStore Gateway.

== Software Requirements ==
=== Operating System ===
MailStore Gateway is supported on the following operating systems:
* Microsoft Windows 11
* Microsoft Windows 10 (1607 or higher)
* Microsoft Windows Server 2025 (Essentials, Standard, Datacenter, Datacenter Azure Edition)
* Microsoft Windows Server 2022 (Essentials, Standard, Datacenter)
* Microsoft Windows Server 2019 (Essentials, Standard, Datacenter)
* Microsoft Windows Server 2016 (Essentials, Standard, Datacenter)
The TCP SMTP ports 25, 465 and 587, the TCP POP3 ports 110 and 995, and the TCP HTTPS port 8450 must not be used by any other program, such as an email server.

=== Web Browsers ===
The following web browsers in their respective current version are supported by the Management Console:
* Microsoft Edge (based on Chromium)
* Google Chrome
* Mozilla Firefox

=== Network ===
* Administrative access to the DNS zone is required to manage A and MX records.
* Administrative access to the firewall is required to manage port-forwarding rules.

=== Other Software ===
The following other software is required:
* [https://dotnet.microsoft.com/en-us/download/dotnet/8.0 Microsoft ASP.NET Core Runtime 8]
[[de:Systemanforderungen]]
[[en:System Requirements]]

System Requirements

2026-02-23T13:47:25Z

Cstelzmann:

__NOTOC__
Before beginning the installation of MailStore Gateway, all system requirements must be met.

== Hardware Requirements ==
{| class="wikitable" width="100%"
! width="150" scope="row" | '''Processor'''
| Any x64 compatible CPU
|-
! width="150" scope="row" | '''Main Memory'''
| 512 MB
|-
! width="150" scope="row" | '''Hard Disk'''
| 150 MB available disk space + enough disk space to store expected email volume.
|-
! width="150" scope="row" | '''Network Bandwidth'''
| 100 MBit/s
|}

Important Notice:When using in conjunction with MailStore SPE use a separate system with Enterprise SSD Storage for MailStore Gateway.

== Software Requirements ==
=== Operating System ===
MailStore Gateway is supported on the following operating systems:
* Microsoft Windows 11
* Microsoft Windows 10 (1607 or higher)
* Microsoft Windows Server 2025 (Essentials, Standard, Datacenter, Datacenter Azure Edition)
* Microsoft Windows Server 2022 (Essentials, Standard, Datacenter)
* Microsoft Windows Server 2019 (Essentials, Standard, Datacenter)
* Microsoft Windows Server 2016 (Essentials, Standard, Datacenter)
The TCP SMTP ports 25, 465 and 587, the TCP POP3 ports 110 and 995, and the TCP HTTPS port 8450 must not be used by any other program, such as an email server.

=== Web Browsers ===
The following web browsers in their respective current version are supported by the Management Console:
* Microsoft Edge (based on Chromium)
* Google Chrome
* Mozilla Firefox

=== Network ===
* Administrative access to the DNS zone is required to manage A and MX records.
* Administrative access to the firewall is required to manage port-forwarding rules.

=== Other Software ===
The following other software is required:
* [https://dotnet.microsoft.com/en-us/download/dotnet/8.0 Microsoft ASP.NET Core Runtime 8]
[[de:Systemanforderungen]]
[[en:System Requirements]]

Quick Start Guide

2024-07-16T13:49:21Z

Cstelzmann:

=== Installation ===
* Download the MailStore Gateway setup file from here [https://www.mailstore.com/en/products/mailstore-gateway/].
* Start the installation process by double-clicking on the downloaded setup file .
* Select the language and click ''OK''.
* Read the license agreement.
* Select ''I accept the agreement'' and click ''Next''.
* Specify the target folder for the program files (default: ''C:\Program Files\MailStore\MailStore Gateway'') and click ''Next''.
* The setup program now extracts all program files into the given target folder.
* Click Finish to exit the installation program.

=== Initial Configuration ===
The initial configuration must be performed to set up the email domain and TLS certificate to use. Furthermore, the network environment must be adapted so that emails can be delivered to MailStore Gateway.

* Start the MailStore Gateway Config Tool by clicking on the desktop shortcut MailStore Gateway.
* Configure the ''E-Mail Domain'' by entering the domain you want to be handled by MailStore Gateway. Usually this domain is different than your primary domain.
* Add an A-record to your DNS zone which points to the public IP address of the MailStore Gateway server. The A-record should match one of the SANs (Subject Alternative Names) of the TLS certificate to be used.
* Add an MX-record to your DNS zone which points to the name of the A-record created in the previous step. The MX-record must match the ''E-Mail Domain'' setting.
* If MailStore Gateway is located behind a NAT router or firewall, additional configuration may be needed, e.g. SMTP and HTTP may need to be forwarded to MailStore Gateway. Refer to [[Firewall Configuration]] for further details.
*: [[File:MailStore Gateway Configuration.png|center|450px]]
* Leave the Management-console port set to the default of 8450 and the Let's Encrypt Port set to the default of 80.
* Next to the ''Certificate'' field, click the three dots box and select ''Create self-signed certificate...''.
* Enter the desired ''Common Name'' of the certificate. This name is also used as a ''Subject Alternative Name'' (SAN) of the certificate.
* Click ''OK''. The self-signed certificate is created and selected.
** Alternatively choose ''Obtain from Let's Encrypt...'' to obtain a certificate from Let's Encrypt. Refer to [[Using_Let%27s_Encrypt_Certificates|this article]] for further details.
* Click the ''Apply'' button to apply the configuration changes.
* Click ''Start Service'' to start the service.

=== Creating A MailStore Gateway Mailbox ===
To log onto the MailStore Gateway Management Console and create a mailbox follow these instructions.
* Open a [[System_Requirements|supported web browser]].
* Navigate to <tt><nowiki>https://<hostname-of-mailstore-gateway-server>:8450</nowiki></tt>.
* Accept possible certificate warnings from your web browser when using a self-signed certificate.
*: [[File:MailStore_Gateway_Login.png|center|450px]]
* In the ''User Name'' field enter ''admin''.
* In the ''Password'' field enter the corresponding password of the admin user. For the first time login, the password is ''admin''. After the first login, a random, secure password is created automatically.
* Click ''Sign in'' to proceed.
* Click ''Create Mailbox'' to proceed.
* Type a name in the ''Name'' field, i.e. ''M365 Journal Mailbox''.
* ''Optional: '' Enter a description that helps to identify the purpose of the mailbox, e.g. ''Target for journal emails from Microsoft 365''.
* Click ''OK''.
* A strong, random password is generated and displayed.
*: [[File:JournalMailboxSetup.png|center|350px]]
* Carefully read the warning, copy the password, and afterwards tick the checkbox ''I've read and understood the above warning''.
* Click ''OK'' to finish the mailbox creation. 
*; '''Important notice:''' Make sure to store the password in a safe place as it is not stored in MailStore Gateway. The password is needed to decrypt the content of the mailbox. If the password is lost, there is no way to access emails that are still in the mailbox ever again; a lost password cannot be retrieved. For MailStore Server customers we recommend to use an enterprise password manager to store such critical passwords. For MSPs using MailStore Service Provider Edition we do not recommend to store these passwords but instead ensure that when providing them to end customers, add a note about the importance of keeping the password safe.

=== Using your new journal Mailbox hosted on MailStore Gateway===

* You now have a functional gateway mailbox to receive journal messages from your email host.
*: [[File:MailStore_Gateway_Management_Console_mailbox.png|center|450px]]
* From our domain above, the functional gateway mailbox address is as below: '' mbx-e52cdd7279194af9c57b3c2a064a7db@gateway.example.com''
* Head back to MailStore Server and set up archiving profiles that transfer the messages from MailStore Gateway to MailStore Server. [https://help.mailstore.com/en/server/MailStore_Help]

[[de:Quick Start Guide]]
[[en:Quick Start Guide]]

Move MailStore Gateway to new machine

2024-07-16T12:59:46Z

Cstelzmann:

MailStore Gateway has multiple dependencies to network infrastructure. Depending on your specific setup, firewalls and DNS zones have to be re-configured as well. Please read the following instructions carefully before starting the process.

== Scenarios ==
The following scenarios are covered:
* MailStore Gateway is exposed to the internet through a firewall. It does not matter, whether the firewall only does port-forwarding or acts as reverse proxy.
* MailStore Gateway is exposed to the internet directly, e.g. when running in Azure or AWS.
Most steps are the same for both scenarios, differences will be pointed out when necessary.

== Steps to Follow ==
To move MailStore Gateway to a new machine, please follow the steps below:

* If MailStore Gateway is exposed to the internet directly, it might be beneficial to lower the TTL of the MX record of the Gateway email domain that points to the old machine beforehand.
* Create a [[Backup_and_Restore|backup]] of your OLD machine.
* [[Installing_MailStore_Gateway|Install]] MailStore Gateway on the NEW machine. The download can be found here [https://www.mailstore.com/en/products/mailstore-gateway/].
* On the NEW machine start the [[Configuration_Tool|MailStore Gateway Config Tool]] by clicking on the desktop shortcut ''MailStore Gateway''.
* On the NEW machine stop the Gateway service by clicking ''Stop Service''.
* On the NEW machine close the MailStore Gateway Config Tool.
* Copy the files ''config.json'' and ''gateway.db'' in the folder ''C:\ProgramData\MailStore\Gateway'' from the OLD machine to the same folder of the NEW machine, overwriting existing files.
* If using a third-party TLS certificate, copy and install the certificate to the NEW machine.
* Reopen the MailStore Gateway Config Tool from the desktop of the NEW machine and verify your settings. Especially that of the email domain and the certificate. [[Using_Let%27s_Encrypt_Certificates|Re-configure Let's Encrypt]], if necessary.
* Start the MailStore Gateway Service on the NEW machine.
* If MailStore Gateway is exposed to the internet through a firewall, adjust [[Firewall_Configuration|firewall settings]] to forward Gateway traffic to the NEW machine.
* Adjust DNS settings, if necessary.
* If MailStore Gatway is exposed to the internet directly, adjust the MX record of the Gateway email domain to point to the NEW machine. Adjust the TTL in case it has been altered beforehand.
* Ensure the NEW machine is receiving mails.
* Ensure the OLD machine is not receiving mails, anymore. If MailStore Gateway is directly exposed to the internet, depending on the TTL of the MX record, this might take 24 hours or even longer.
* After the machine is not receiving mails anymore, archive the remaining mails from the OLD machine.
* Adjust the archiving profiles in MailStore Server to point to the new Gateway.
* Adjust email client settings to point to the new Gateway if used as email proxy.
* Decommission the OLD machine.

[[de:MailStore Gateway auf einen anderen Server verschieben]]
[[en:Move_MailStore_Gateway_to_new_machine]]

Move MailStore Gateway to new machine

2024-07-16T12:54:52Z

Cstelzmann:

MailStore Gateway has multiple dependencies to network infrastructure. Depending on your specific setup, firewalls and DNS zones have to be re-configured as well.

== Scenarios ==
The following scenarios are covered:
* MailStore Gateway is exposed to the internet through a firewall. It does not matter, whether the firewall only does port-forwarding or acts as reverse proxy.
* MailStore Gateway is exposed to the internet directly, e.g. when running in Azure or AWS.
Most steps are the same for both scenarios, differences will be pointed out when necessary.

== Steps to Follow ==
To move MailStore Gateway to a new machine, please follow the steps below:

* If MailStore Gateway is exposed to the internet directly, it might be beneficial to lower the TTL of the MX record of the Gateway email domain that points to the old machine beforehand.
* Create a [[Backup_and_Restore|backup]] of your OLD machine.
* [[Installing_MailStore_Gateway|Install]] MailStore Gateway on the NEW machine. The download can be found here [https://www.mailstore.com/en/products/mailstore-gateway/].
* On the NEW machine start the [[Configuration_Tool|MailStore Gateway Config Tool]] by clicking on the desktop shortcut ''MailStore Gateway''.
* On the NEW machine stop the Gateway service by clicking ''Stop Service''.
* On the NEW machine close the MailStore Gateway Config Tool.
* Copy the files ''config.json'' and ''gateway.db'' in the folder ''C:\ProgramData\MailStore\Gateway'' from the OLD machine to the same folder of the NEW machine, overwriting existing files.
* If using a third-party TLS certificate, copy and install the certificate to the NEW machine.
* Reopen the MailStore Gateway Config Tool from the desktop of the NEW machine and verify your settings. Especially that of the email domain and the certificate. [[Using_Let%27s_Encrypt_Certificates|Re-configure Let's Encrypt]], if necessary.
* Start the MailStore Gateway Service on the NEW machine.
* If MailStore Gateway is exposed to the internet through a firewall, adjust [[Firewall_Configuration|firewall settings]] to forward Gateway traffic to the NEW machine.
* Adjust DNS settings, if necessary.
* If MailStore Gatway is exposed to the internet directly, adjust the MX record of the Gateway email domain to point to the NEW machine. Adjust the TTL in case it has been altered beforehand.
* Ensure the NEW machine is receiving mails.
* Ensure the OLD machine is not receiving mails, anymore. If MailStore Gateway is directly exposed to the internet, depending on the TTL of the MX record, this might take 24 hours or even longer.
* After the machine is not receiving mails anymore, archive the remaining mails from the OLD machine.
* Adjust the archiving profiles in MailStore Server to point to the new Gateway.
* Adjust email client settings to point to the new Gateway if used as email proxy.
* Decommission the OLD machine.

[[de:MailStore Gateway auf einen anderen Server verschieben]]
[[en:Move_MailStore_Gateway_to_new_machine]]

Move MailStore Gateway to new machine

2024-07-16T11:46:37Z

Cstelzmann:

MailStore Gateway has multiple dependencies to network infrastructure. Depending on your specific setup, firewalls and DNS zones have to be re-configured as well.

== MailStore Gateway behind a firewall ==

In this scenario it is assumed, that MailStore Gateway is exposed to the internet through a firewall. It does not matter, whether the firewall only does port-forwarding or acts as reverse proxy.

To move MailStore Gateway to a new machine, please follow the steps below:

* Create a [[Backup_and_Restore|backup]] of your OLD machine.
* [[Installing_MailStore_Gateway|Install]] MailStore Gateway on the NEW machine. The download can be found here [https://www.mailstore.com/en/products/mailstore-gateway/].
* On the NEW machine start the [[Configuration_Tool|MailStore Gateway Config Tool]] by clicking on the desktop shortcut ''MailStore Gateway''.
* On the NEW machine stop the Gateway service by clicking ''Stop Service''.
* On the NEW machine close the MailStore Gateway Config Tool.
* On the NEW machine navigate into the folder ''C:\ProgramData\MailStore'' and delete the ''Gateway'' sub-folder.
* Log in the web interface of the OLD machine and [[Management_Console#Edit_Mailbox|suspend all mailboxes]].
* Copy the folder ''C:\ProgramData\MailStore\Gateway'' from the OLD machine to the NEW machine.
* If using a third-party TLS certificate, copy and install the certificate to the NEW machine.
* Reopen the MailStore Gateway Config Tool from the desktop of the NEW machine and verify your settings. Especially that of the email domain and the certificate. [[Using_Let%27s_Encrypt_Certificates|Re-configure Let's Encrypt]], if necessary.
* Start the MailStore Gateway Service on the NEW machine.
* Log in the web interface of the NEW machine and [[Management_Console#Edit_Mailbox|activate all mailboxes]].
* Adjust [[Firewall_Configuration|firewall settings]] to forward Gateway traffic to the NEW machine.
* Adjust DNS settings, if necessary.
* Ensure the NEW machine is receiving mails.
* Adjust the archiving profiles in MailStore Server to point to the new Gateway.
* Adjust email client settings to point to the new Gateway if used as email proxy.
* Decommission the OLD machine.

== MailStore Gateway directly exposed to the internet ==

When MailStore Gateway is exposed to the internet directly, e.g. when running in Azure or AWS, follow the steps below. For a faster migration, it might be beneficial to lower the TTL of the MX record of the Gateway email domain that points to the old machine beforehand:

* Create a [[Backup_and_Restore|backup]] of your OLD machine.
* [[Installing_MailStore_Gateway|Install]] MailStore Gateway on the NEW machine. The download can be found here [https://www.mailstore.com/en/products/mailstore-gateway/].
* On the NEW machine start the [[Configuration_Tool|MailStore Gateway Config Tool]] by clicking on the desktop shortcut ''MailStore Gateway''.
* On the NEW machine stop the Gateway service by clicking ''Stop Service''.
* On the NEW machine close the MailStore Gateway Config Tool.
* On the NEW machine navigate into the folder ''C:\ProgramData\MailStore'' and delete the ''Gateway'' sub-folder.
* On the OLD and machine start the MailStore Gateway Config Tool by clicking on the desktop shortcut ''MailStore Gateway''.
* On the OLD machine stop the Gateway service by clicking ''Stop Service''.
* Copy the folder ''C:\ProgramData\MailStore\Gateway'' from the OLD machine to the NEW machine.
* If using a third-party TLS certificate, copy and install the certificate to the NEW machine.
* Start the MailStore Gateway Service on the OLD machine.
* Reopen the MailStore Gateway Config Tool from the desktop of the NEW machine and verify your settings. Especially that of the email domain and the certificate. [[Using_Let%27s_Encrypt_Certificates|Re-configure Let's Encrypt]], if necessary.
* Start the MailStore Gateway Service on the NEW machine.
* Adjust DNS settings, the MX record of the Gateway email domain must point to the NEW machine. Adjust the TTL in case it has been altered beforehand.
* Ensure the NEW machine is receiving mails.
* Archive the remaining mails from the OLD machine.
* Adjust the archiving profiles in MailStore Server to point to the new Gateway.
* Adjust email client settings to point to the new Gateway if used as email proxy.
* Decommission the OLD machine.

[[de:MailStore Gateway auf einen anderen Server verschieben]]
[[en:Move_MailStore_Gateway_to_new_machine]]

Move MailStore Gateway to new machine

2024-07-16T11:45:04Z

Cstelzmann:

MailStore Gateway has multiple dependencies to network infrastructure. Depending on your specific setup, firewalls and DNS zones have to be re-configured as well.

== MailStore Gateway behind a firewall ==

In this scenario it is assumed, that MailStore Gateway is exposed to the internet through a firewall. It does not matter, whether the firewall only does port-forwarding or acts as reverse proxy.

To move MailStore Gateway to a new machine, please follow the steps below:

* Create a [[Backup_and_Restore|backup]] of your OLD machine.
* [[Installing_MailStore_Gateway|Install]] MailStore Gateway on the NEW machine. The download can be found here [https://www.mailstore.com/en/products/mailstore-gateway/].
* On the NEW and machine start the [[Configuration_Tool|MailStore Gateway Config Tool]] by clicking on the desktop shortcut ''MailStore Gateway''.
* On the NEW machine stop the Gateway service by clicking ''Stop Service''.
* On the NEW machine close the MailStore Gateway Config Tool.
* On the NEW machine navigate into the folder ''C:\ProgramData\MailStore'' and delete the ''Gateway'' sub-folder.
* Log in the web interface of the OLD machine and [[Management_Console#Edit_Mailbox|suspend all mailboxes]].
* Copy the folder ''C:\ProgramData\MailStore\Gateway'' from the OLD machine to the NEW machine.
* If using a third-party TLS certificate, copy and install the certificate to the NEW machine.
* Reopen the MailStore Gateway Config Tool from the desktop of the NEW machine and verify your settings. Especially that of the email domain and the certificate. [[Using_Let%27s_Encrypt_Certificates|Re-configure Let's Encrypt]], if necessary.
* Start the MailStore Gateway Service on the NEW machine.
* Log in the web interface of the NEW machine and [[Management_Console#Edit_Mailbox|activate all mailboxes]].
* Adjust [[Firewall_Configuration|firewall settings]] to forward Gateway traffic to the NEW machine.
* Adjust DNS settings, if necessary.
* Ensure the NEW machine is receiving mails.
* Adjust the archiving profiles in MailStore Server to point to the new Gateway.
* Adjust email client settings to point to the new Gateway if used as email proxy.
* Decommission the OLD machine.

== MailStore Gateway directly exposed to the internet ==

When MailStore Gateway is exposed to the internet directly, e.g. when running in Azure or AWS, follow the steps below. For a faster migration, it might be beneficial to lower the TTL of the MX record of the Gateway email domain that points to the old machine beforehand:

* Create a [[Backup_and_Restore|backup]] of your OLD machine.
* [[Installing_MailStore_Gateway|Install]] MailStore Gateway on the NEW machine. The download can be found here [https://www.mailstore.com/en/products/mailstore-gateway/].
* On the NEW and machine start the [[Configuration_Tool|MailStore Gateway Config Tool]] by clicking on the desktop shortcut ''MailStore Gateway''.
* On the NEW machine stop the Gateway service by clicking ''Stop Service''.
* On the NEW machine close the MailStore Gateway Config Tool.
* On the NEW machine navigate into the folder ''C:\ProgramData\MailStore'' and delete the ''Gateway'' sub-folder.
* On the OLD and machine start the MailStore Gateway Config Tool by clicking on the desktop shortcut ''MailStore Gateway''.
* On the OLD machine stop the Gateway service by clicking ''Stop Service''.
* Copy the folder ''C:\ProgramData\MailStore\Gateway'' from the OLD machine to the NEW machine.
* If using a third-party TLS certificate, copy and install the certificate to the NEW machine.
* Start the MailStore Gateway Service on the OLD machine.
* Reopen the MailStore Gateway Config Tool from the desktop of the NEW machine and verify your settings. Especially that of the email domain and the certificate. [[Using_Let%27s_Encrypt_Certificates|Re-configure Let's Encrypt]], if necessary.
* Start the MailStore Gateway Service on the NEW machine.
* Adjust DNS settings, the MX record of the Gateway email domain must point to the NEW machine. Adjust the TTL in case it has been altered beforehand.
* Ensure the NEW machine is receiving mails.
* Archive the remaining mails from the OLD machine.
* Adjust the archiving profiles in MailStore Server to point to the new Gateway.
* Adjust email client settings to point to the new Gateway if used as email proxy.
* Decommission the OLD machine.

[[de:MailStore Gateway auf einen anderen Server verschieben]]
[[en:Move_MailStore_Gateway_to_new_machine]]

System Requirements

2023-02-07T12:47:56Z

Cstelzmann: /* Operating System */

__NOTOC__
Before beginning the installation of MailStore Gateway, all system requirements must be met.

== Hardware Requirements ==
{| class="wikitable" width="100%"
! width="150" scope="row" | '''Processor'''
| Any x64 compatible CPU
|-
! width="150" scope="row" | '''Main Memory'''
| 512 MB
|-
! width="150" scope="row" | '''Hard Disk'''
| 150 MB available disk space + enough disk space to store expected email volume.
|-
! width="150" scope="row" | '''Network Bandwidth'''
| 100 MBit/s
|}

== Software Requirements ==
=== Operating System ===
MailStore Gateway is supported on the following operating systems:
* Microsoft Windows 10 (1607 or higher)
* Microsoft Windows Server 2019 (Essentials, Standard, Datacenter)
* Microsoft Windows Server 2016 (Essentials, Standard, Datacenter)
* Microsoft Windows Server 2012 R2 (Foundation, Essentials, Standard, Datacenter)
* Microsoft Windows Server 2012 (Foundation, Essentials, Standard, Datacenter)
The TCP SMTP ports 25, 465 and 587, the TCP POP3 ports 110 and 995, and the TCP HTTPS port 8450 must not be used by any other program, such as an email server.

=== Web Browsers ===
The following web browsers in their respective current version are supported by the Management Console:
* Microsoft Edge (based on Chromium)
* Google Chrome
* Mozilla Firefox

=== Other Software ===
The following other software is required:
* [https://dotnet.microsoft.com/en-us/download/dotnet/6.0 Microsoft .NET 6 Runtime]
[[de:Systemanforderungen]]
[[en:System Requirements]]