Install the grammm appliance.

Quick Start

A short guide that can be used as a checklist for installing and starting grammm.

  1. Download the installation ISO. The image is a CD / USB hybrid installation medium for x86_64, which can also be transferred to a USB stick with USB imaging tools such as
  2. Use the installation medium from grammm for the installation and the quick start of the configuration by going through the following chapters.
  3. Create or apply for SSL certificates for the secure, encrypted operation of the most important services.
  4. Create the appropriate DNS records with a reasonable configuration (A, MX, TXT and CNAME records).
  5. Configure the grammm appliance by running grammm-setup.

Minimum requirements

The following minimum requirements apply to the installation of grammm (or the use of the grammm appliance):

  • Server or virtual machine (VMware, XEN or Hyper-V) with at least:
    • 4 CPU cores
    • 4 GB RAM
  • Correctly configured DNS entries, at least 2, for example:
  • SSL certificate with all DNS names contained, alternatively wildcard certificate for the entire domain. (Let’s Encrypt can be created with grammm-setup.

If you already have a certificate, it can be used, but it must be in PEM format, with a file containing the certificate chain and server certificate, and a separate key file.


It is strongly recommended that you have correctly set the relevant DNS entries, otherwise AutoDiscover cannot determine the server.
Optional requirements

  1. MX DNS records for the delivery of incoming emails.
  2. At the time the certificate is generated by Let’s Encrypt, port 80 must be accessible for all defined DNS entries.


  1. Download the ISO file
  2. For installation, load the ISO file on the server on which grammm is to be installed.
  3. Start the installer and select “Installation” at the boot prompt to install grammm.


Please note that the installer asks you to confirm the installation. Please note that this will overwrite and delete the installation target!
After installing the grammm appliance, grammm is ready for setup.


After installing and restarting the grammm appliance, the server displays the grammm cui (console user interface).


The initial root password is not set (empty). When asked for the password, simply confirm with “Enter”.
To configure grammm, please proceed as follows:

  1. Set a self-defined root password.
  2. Set an IP address, a host name and DNS server. If you are using DHCP (e.g. for test purposes – it is at least recommended to use static DHCP reservations because of the DNS entries), this part can be skipped.
  3. After this basic configuration has been made, grammm-setup can be executed to take over the last steps.
  4. To start grammm-setup, please use either the grammm cui or any other terminal of the appliance.


SSH is activated by default, so grammm-setup can also be executed via remote SSH.
Finally start grammm-setup as user root and follow the instructions of the interactively requested information.


For smooth operation, the grammm appliance opens various ports so that clients can access it. Please note that the following ports are open by default:

  • 25 (smtp)
  • 80 (http)
  • 110 (pop3)
  • 143 (imap)
  • 993 (imaps)
  • 995 (pop3s)
  • 8080 (admin)

Download the grammm appliance as an ISO