# Installation of grommunio – Building Your Own Groupware Platform

Source: https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform
Language: en
Published: 2026-04-15
Updated: 2026-11-18

Installation of grommunio – Building Your Own Groupware Platform Practical guide including pre-configuration, installation, DNS setup, testing, and forecast…

## Goal of this guide

This article makes grommunio platform practical from an operations perspective: you understand the value, the key decisions and the validation points that must be correct before production use.

## Prerequisites

An existing or planned grommunio environment, matching DNS names, TLS, administrative access and a clear target for mail, collaboration or operations.

## **Installation of grommunio – Building Your Own Groupware Platform**
_Practical guide including pre-configuration, installation, DNS setup, testing, and forecast_

## 1. Introduction

With grommunio, a modern groupware solution is available that deliberately positions itself as an alternative to traditional cloud offerings such as Microsoft 365 or Exchange. Developed in Austria and fully open source, grommunio provides a modular platform for email, calendars, contacts, and collaboration.

A key advantage lies in its architecture: grommunio is delivered as an appliance, based on openSUSE, and can be brought into operation relatively quickly. At the same time, the solution remains flexible enough to be deployed in more complex infrastructures or fully automated rollouts.

In this article, we demonstrate how to set up a grommunio instance using the appliance – including typical pitfalls that are actually relevant in practice. These are often the deciding factors between a smooth installation and one that runs into avoidable issues early on.

[![grommunio setup 1 features](https://forgeone.solutions/media/grommunio_setup_1_features.webp)](https://forgeone.solutions/media/grommunio_setup_1_features.webp)

## 2. Preparing the Infrastructure

Before starting the actual installation, the environment should be properly prepared. In our case, the system is operated in a virtualized setup, for example using Proxmox. First, a virtual machine is created and the network is correctly assigned. This includes assigning the correct VLAN and ensuring that the VM will later be reachable under the intended IP address.

Next, the appliance ISO is mounted and the VM is started. The installation itself is generally straightforward but requires clean preparation. Network, DNS, and name resolution should be correctly configured before starting.

[![grommunio Setup 2 Proxmox Settings](https://forgeone.solutions/media/grommunio_setup_2_proxmox_settings.webp)](https://forgeone.solutions/media/grommunio_setup_2_proxmox_settings.webp)

An important point: If Let’s Encrypt is to be used later for certificates, the DNS names must already be correctly set before installation or certificate issuance. Without proper name resolution or a reachable FQDN, certificate issuance will often fail.

Another relevant limitation of the appliance: predefined LVM partitioning cannot currently be cleanly configured during the appliance installation. If LVM or a custom storage layout is required, these adjustments must be performed manually afterward.

A brief outlook: besides the appliance, grommunio can also be installed fully manually or automated (e.g., via Ansible) on Red Hat-, Debian-, or SUSE-based systems. However, the appliance is the easiest entry point, especially for an initial proof of concept or a quick core deployment.

[![grommunio Setup 3 Boot Screen](https://forgeone.solutions/media/grommunio_setup_3_boot_screen.webp)](https://forgeone.solutions/media/grommunio_setup_3_boot_screen.webp)

[![grommunio setup 4 cui start](https://forgeone.solutions/media/grommunio_setup_4_cui_start.webp)](https://forgeone.solutions/media/grommunio_setup_4_cui_start.webp)

[![grimmunio setup 5 cui interface](https://forgeone.solutions/media/grommunio_setup_5_cui_interface.webp)](https://forgeone.solutions/media/grommunio_setup_5_cui_interface.webp)

Here you can already set the system password as a first step:

[![grommunio setup 6 set password](https://forgeone.solutions/media/grommunio_setup_6_set_password.webp)](https://forgeone.solutions/media/grommunio_setup_6_set_password.webp)

[![grommunio setup 7 password](https://forgeone.solutions/media/grommunio_setup_7_password_successful.webp)](https://forgeone.solutions/media/grommunio_setup_7_password_successful.webp)

If successful, the next step is to begin with the network configuration.

## 3. Network Pre-Configuration

A common pitfall during appliance installation is network configuration. While YaST2 initially appears convenient, it can be misleading in practice. Although IP address and subnet are visible, the default gateway is not configured where many would expect it. This often leads to a situation where the system appears reachable locally but lacks proper upstream connectivity.

In practice, it has proven useful to configure the network cleanly via the terminal before starting the actual setup. This ensures that hostname, DNS, routing, and IP configuration are consistent.

The following should be fully configured before starting the guided setup:

- valid hostname / FQDN
- static IP address
- default gateway
- DNS server
- search domain
- working name resolution

## Configuration with YaST2

We configure the network interface, hostname and DNS, as well as the routing.
The network interface itself is set to static:

[![grommunio setup 8 interface configuration](https://forgeone.solutions/media/grommunio_setup_8_interface_configuration.webp)](https://forgeone.solutions/media/grommunio_setup_8_interface_configuration.webp)

In the next step, we configure the DNS settings:

[![grommunio setup 9 dns configuration](https://forgeone.solutions/media/grommunio_setup_9_dns_configuration.webp)](https://forgeone.solutions/media/grommunio_setup_9_dns_configuration.webp)

If necessary, static routes or the default gateway are also configured:

[![grommunio setup 10 route configuration](https://forgeone.solutions/media/grommunio_setup_10_route_configuration.webp)](https://forgeone.solutions/media/grommunio_setup_10_route_configuration.webp)

After making the changes, switch to the terminal and test connectivity by pinging an external IP address and a DNS name:

[![grommunio setup 11 ping check](https://forgeone.solutions/media/grommunio_setup_11_ping_check.webp)](https://forgeone.solutions/media/grommunio_setup_11_ping_check.webp)

## Configuration via the terminal

We configure the network interface, hostname and DNS, as well as the routing.
The network interface itself is set to static; the file is located at /etc/sysconfig/network/ifcfg-eth0:

```bash
SERCONTROL='no'
IPADDR='188.40.144.21/24'
BOOTPROTO='static'
STARTMODE='auto'
ZONE='public'
```

After that:

```bash
ifdown eth0
ifup eth0
```

In the next step, we configure the DNS settings in `/etc/resolv.conf`:

```bash
search forgeone.eu
nameserver 9.9.9.9
nameserver 149.112.112.112
```

If necessary, static routes or the default gateway are also configured in `/etc/sysconfig/network/ifroute-eth0`:

```bash
default 188.40.144.254 - eth0
```

After making the changes, restart `wicked`:

```bash
systemctl restart wicked
```

Afterwards, test connectivity by pinging an external IP address and a DNS name:

```typescript
ping 1.1.1.1
PING 1.1.1.1 (1.1.1.1) 56(84) bytes of data.
64 bytes from 1.1.1.1: icmp_seq=1 ttl=56 time=5.56 ms

ping google.at
PING google.at (142.251.141.163) 56(84) bytes of data.
64 bytes from lcprga-ag-in-f3.1e100.net (142.251.141.163): icmp_seq=1 ttl=116 time=12.4 ms
```

This step is crucial. If the gateway, DNS, or FQDN are not working properly before the setup, errors often occur later with package repositories, name resolution, or certificate issuance. The system may appear to be installed, but it is not yet properly prepared for operation.

Whether using YaST2 or configuring directly via the CLI, both approaches must result in a working network connection.

## 4. Starting the Installation and First Steps

After preparation, the appliance can be started and configured via the CUI interface. Even though this process is guided, it is still important that the base configuration has already been correctly set.

[![grommunio setup 12 guided installation](https://forgeone.solutions/media/grommunio_setup_12_guided_installation_1.webp)](https://forgeone.solutions/media/grommunio_setup_12_guided_installation_1.webp)

[![grommunio setup 13 guided installation 2](https://forgeone.solutions/media/grommunio_setup_13_guided_installation_2.webp)](https://forgeone.solutions/media/grommunio_setup_13_guided_installation_2.webp)

[![grommunio setup 14 guided instalation 3](https://forgeone.solutions/media/grommunio_setup_14_guided_installation_3.webp)](https://forgeone.solutions/media/grommunio_setup_14_guided_installation_3.webp)

The installer then proceeds to the guided installation, where components can be selected:

- Core – groupware for email, calendar, and contacts
- Meet – adapted Jitsi
- Chat – adapted Mattermost
- Files – adapted Nextcloud
- Office – adapted OnlyOffice
- Archive – adapted Piler
- Auth – adapted Keycloak (currently installed separately)

It is important to note that only the packages or modules for which the appropriate licenses are available are supported. For example, a basic license only supports the core functions and not the additional modules. “Supported” means that while all modules can technically be installed, if an issue occurs within those modules—or if such an issue affects a module covered by the license—only uninstalling the unsupported module will resolve it, as it is otherwise not covered.

The license you receive from a grommunio partner can be activated here. If you leave the fields empty, the Community Edition will be installed.

[![grommunio setup 15 guided installation](https://forgeone.solutions/media/grommunio_setup_15_guided_installation_4.webp)](https://forgeone.solutions/media/grommunio_setup_15_guided_installation_4.webp)

[![grommunio setup 16 guided installation 5](https://forgeone.solutions/media/grommunio_setup_16_guided_installation_5.webp)](https://forgeone.solutions/media/grommunio_setup_16_guided_installation_5.webp)

[![grommunio setup 17 guided installation 6](https://forgeone.solutions/media/grommunio_setup_17_guided_installation_6.webp)](https://forgeone.solutions/media/grommunio_setup_17_guided_installation_6.webp)

This is where it is determined whether the public DNS records have already been set correctly in advance if you choose Let’s Encrypt. Alternatively, you can proceed with a self-signed certificate or your own certificate.

[![grommunio setup 18 guided installation 7](https://forgeone.solutions/media/grommunio_setup_18_guided_installation_7.webp)](https://forgeone.solutions/media/grommunio_setup_18_guided_installation_7.webp)

The remainder of the installation process is generally straightforward. If there are issues with certificate issuance using certbot and Let’s Encrypt, this step can also be triggered again later via the CLI.

```bash
certbot --nginx -d mail.forgeone.eu -d webmail.forgeone.eu -d autodiscover.forgeone.eu
```

## 5. Domain and DNS Configuration After Installation

After successful installation, configuration continues in the grommunio web interface. Optionally, an organization can be created. Within it (or directly), the desired mail domain is configured.

Once the domain is set up, required DNS records can be configured:

- MX records
- SPF (TXT)
- DKIM
- DMARC
- SRV records

[![grommunio setup terminal check](https://forgeone.solutions/media/grommunio-setup-05-terminal-check.webp)](https://forgeone.solutions/media/grommunio-setup-05-terminal-check.webp)

[![grommunio setup with console check](https://forgeone.solutions/media/grommunio-setup-05-console-check.webp)](https://forgeone.solutions/media/grommunio-setup-05-console-check.webp)

A particularly important point is DKIM. If no DKIM key is available yet, OpenDKIM can be installed afterward and the key can be generated manually. The keys are typically stored under `/etc/opendkim/keys/<example.com>/`. In this case, however, we place them in `/var/lib/grommunio-antispam/dkim/forgeone.eu/`.

```bash
zypper install opendkim
```

Creating the directories, generating the DKIM private and public keys, and setting the permissions:

```bash
mkdir -p /var/lib/grommunio-antispam/dkim/forgeone.eu
cd /var/lib/grommunio-antispam/dkim/forgeone.eu || exit 1

opendkim-genkey -s mail -d forgeone.eu -b 2048

chown groas:grommunio mail.private mail.txt
chmod 640 mail.private
chmod 644 mail.txt
chmod 750 /var/lib/grommunio-antispam/dkim
chmod 750 /var/lib/grommunio-antispam/dkim/forgeone.eu
```

After generating the key, the public part (in `mail.txt`) must be added to the DNS zone.

```bash
mail._domainkey	IN	TXT	( "v=DKIM1; k=rsa; "
	  "p=MIIBIjANBgkqhkiG9w0BAQEFAAOCAQ8AMIIBCgKCAQEAnAOkWGe+4sPuzxzz8VYzet9RkmljJ6/
```

In addition, the DKIM signing must be made known to rspamd so that outgoing emails for the respective domain are properly signed.

```bash
vim /etc/grommunio-antispam/override.d/dkim_signing.conf
```

Then copy the following content into `dkim\_signing.conf`:

```bash
enabled = true;

use_domain = "header";
sign_authenticated = true;
sign_local = true;
try_fallback = false;
selector = "mail";
domain {
  forgeone.eu {
    path = "/var/lib/grommunio-antispam/dkim/forgeone.eu/mail.private";
    selector = "mail";
  }
}

symbol = "DKIM_SIGNED";
```

After that, restart the services and check whether `grommunio-antispam` has started up again:

```bash
stemctl restart grommunio-antispam

systemctl status grommunio-antispam

journalctl -u grommunio-antispam -f
```

## 6. Testing and Initial Delivery

Once the core system, DNS, and signing are configured, testing follows. A very useful tool in this context is mail-tester.com. It allows you to verify whether SPF, DKIM, and DMARC are working correctly and how the delivery quality is rated from the perspective of external recipients.

Especially with new mail servers, it should also be taken into account that some providers—such as t-online.de—block new mail servers or new IP addresses by default. In the initial response, it is usually stated that you need to contact them proactively so that the server’s or IP address’s reputation can be approved or reset.

This step is not unusual, but it should be planned for to ensure that production operation runs smoothly later on.

[https://mail-tester.com](https://mail-tester.com) (the free version allows a limited number of tests per day)

[![grommunio setup 21 mail tester](https://forgeone.solutions/media/grommunio_setup_21_mail_tester.webp)](https://forgeone.solutions/media/grommunio_setup_21_mail_tester.webp)

## 7. Current State and Manual Adjustments

As of March 22, 2026, some steps still require manual work after appliance installation:

- DKIM configuration
- grommunio-auth / Keycloak integration

These are straightforward to implement once the base configuration is stable. After that, the server is fully operational for core use.

## 8. Conclusion

The grommunio appliance enables setting up a complete groupware platform in a short time. While installation itself is simple, proper preparation—especially regarding network, DNS, and FQDN—is crucial.

Getting these basics right before starting the setup avoids many common issues. That’s why pre-configuration should be done deliberately and systematically.

## 9. Forecast

In the next article, we will demonstrate how to operate grommunio as a cluster or in a high-availability architecture. The focus will be on transforming a single appliance installation into a more robust, scalable, and production-ready setup.

## Operations and validation

After each step, validate services, web access, login, logs and the affected integrations. Production environments also need backup, monitoring, updates and documented rollback steps.

## Production checklist

- Goal, scope and ownership are documented.
- DNS, TLS, networking, accounts and permissions are validated.
- The installation or change is verified with UI and CLI signals.
- Backup, monitoring, updates and rollback are planned before production use.
- Licensing, support paths and professional services are planned for operations.

## Sources and further documentation

Production work should also use the current vendor documentation, release notes, security advisories and your own operational standards. This article summarizes the practical ForgeOne perspective and does not replace project-specific planning.

### Discuss grommunio platform with ForgeOne

ForgeOne supports planning, architecture, installation, migration, operations, support and licensing for open source and enterprise Linux platforms.

- [Discuss your project](https://forgeone.solutions/en/contact)

## Hero image

[![grommunio Admin overview after installation.](https://forgeone.solutions/media/grommunio-2026-install-admin-overview-card.png)](https://forgeone.solutions/media/grommunio-2026-install-admin-overview-card.png)

## Author

Mathias Rumbold

## Category

- [grommunio & Groupware](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?category=grommunio-groupware)

## Tags

- [Open Source](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=open-source)
- [grommunio](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=grommunio)
- [openSUSE](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=opensuse)
- [SUSE](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=suse)
- [grommunio-antispam](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=grommunio-antispam)
- [Rspamd](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=rspamd)
- [Self-Hosted](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=self-hosted)
- [Digital Souvereignity](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=digital-sovereignity)
- [European Open Source Solutions](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=european-open-source-solutions)
- [Keycloak](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=keycloak)
- [SSO](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=sso)
- [MFA](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=mfa)
- [Enterprise Linux](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=enterprise-linux)
- [Upgrade](https://forgeone.solutions/en/tech/installation-of-grommunio-building-your-own-groupware-platform?tags=upgrade)

## Further content

- [grommunio](https://forgeone.solutions/en/products/grommunio)
- [Collaboration](https://forgeone.solutions/en/collaboration)
- [grommunio-auth – Centralized Authentication with Keycloak and Existing SSO](https://forgeone.solutions/en/tech/grommunio-auth-centralized-authentication-with-keycloak-and-existing-sso)
- [grommunio-antispam – efficient spam filtering with centralized management and self-learning mechanisms](https://forgeone.solutions/en/tech/grommunio-antispam-efficient-spam-filtering-with-centralized-management-and-self-learning-mechanisms)
