grommunio Admin Docs

grommunio is a comprehensive communication and collaboration solution that includes e-mail, calendaring, contacts, tasks, notes, video meetings, chat and file management.

Audience

This document is for system administrators installing and operating grommunio.

It is recommended for readers to have at least the following experience for installation and operation:

• An understanding of the technologies and standards: Linux, e-mail (e.g. SMTP), Networking, DNS.

• General concept of the Linux operating system.

• Overall experience with management of communication and/or collaboration solutions.

Contents

• Introduction
  • About
  • Overview & Concepts
  • Architecture
• Quickstart
  • Minimum requirements
  • Installation
  • Setup
    • grommunio Admin User
    • Repository configuration
    • Certificates
  • Firewall
• Guided Installation (grommunio Appliance)
  • grommunio Appliance configuration with CUI/setup
  • Main screen
  • Login
  • Main configuration screen
  • Change system password
  • Network configuration
    • Hostname & FQDN setup
  • Timezone configuration
  • Timesync configuration
  • grommunio setup wizard
    • Welcome screen
    • Repository setup
    • Database variant
    • Database settings
    • Administration User
    • Fully Qualified Domain Name
    • Primary mail domain
    • Relayhost configuration
    • TLS configuration
    • Setup finalization
  • Admin web password reset
  • Terminal
  • Reboot
  • Shutdown
• Manual Installation (Custom Integration)
  • Establish networking
  • Declare hostname identity
  • Package manager setup
    • zypp
    • dnf
    • apt
  • TLS certificates
  • nginx
  • nginx support package
  • TLS for nginx
  • MariaDB
  • Gromox in general
  • Gromox user database
  • gromox-event/timer
  • gromox-http
  • gromox-midb & zcore
  • gromox-imap & pop3
  • PHP-FPM
  • Administration API (AAPI)
    • Permissions
  • nginx support package for AAPI/AWEB
  • Administration Web Interface (AWEB)
    • Known issues
    • Create domain & user
  • grommunio-web
  • Loopback mail
  • Postfix
  • Other services
• Container Installation
  • Prerequisites and Assumptions
  • Installation
    • Quick Start
  • Configuration
    • Persistent Storage
    • Environment Variables
      • General Options
      • Database Options
  • Shell Access
• Administration
  • grommunio admin UI (AUI)
    • Dashboard
      • Antispam
      • Services
      • CPU
      • Memory
      • Disks and swap
      • Load
      • Versions
    • Domains
      • Adding a domain
      • Editing a domain
      • Deleting a domain
      • Reactivating domains
    • Users
      • Adding a user
      • Editing a user
        • Account
        • User & Contact
        • Roles
        • SMTP
        • Permissions
        • OOF
        • Fetchmail
        • Mobile Devices
        • Sync policy
      • Deleting a user
    • Public folders
      • Adding a folder
      • Editing a folder
        • Folder permissions
      • Deleting a folder
    • Groups
      • Adding a group
      • Deleting a group
    • Roles
      • Adding a role
      • Editing a role
      • Deleting a role
    • Organizations
      • Adding an organization
      • Editing an organization
      • Deleting an oranization
    • Defaults
    • Settings
    • License
    • Design
    • LDAP
      • Availability
      • Configuration
      • LDAP Server
      • Authentication manager
      • Attribute Configuration
      • LDAP Search Attributes
      • Custom Mapping
      • User import and synchronisation
      • Domain user import and synchronisation
      • User import
      • Detaching a user
      • Removing orphaned users
    • DB Configuration
      • Adding a file
      • Editing a file
      • Deleting a file
      • Configuring grommunio-dbconf
      • Adding a grommunio-dbconf file
    • Servers
      • Adding a server
      • Editing a server
    • Logs
    • Mail queue
      • Actions
    • Tasks
    • Mobile devices
    • Sync policies
    • Live Status
  • grommunio admin CLI (ACLI)
    • grommunio-admin
      • Name
      • Synopsis
      • Commands
        • check
        • dump, get
        • trace
      • Options
      • Tracing
        • By-File
        • By-Value
      • Name
      • Synopsis
      • Description
      • Options
      • Filesystem Emulation
    • grommunio-admin-dbconf
      • Name
      • Synopsis
      • Description
      • Commands
      • Options
      • grommunio-admin
        • multi-server
      • Commit Hooks
      • Available Commit Commands
        • Key
        • File
        • Service
      • Macros
        • Key
        • File
        • Service
      • Command Variable Expansion
      • Name
      • Synopsis
      • Description
      • Commands
      • Options
      • Fields
      • Name
      • Synopsis
      • Description
      • Commands
        • Folder subcommand
        • Store subcommand
      • Options
      • Notes
      • Name
      • Synopsis
      • Description
      • Commands
      • Options
      • Fields
      • Name
      • Synopsis
      • Description
      • Commands
      • Options
      • Name
      • Synopsis
      • Description
      • Commands
      • Options
      • Name
      • Synopsis
      • Description
      • Commands
      • Options
      • Name
      • Synopsis
      • Description
      • Commands
      • Options
      • Name
      • Synopsis
      • Description
      • Commands
      • Options
      • Fields
      • Name
      • Synopsis
      • Description
      • Options
      • Name
      • Synopsis
      • Description
      • Options
      • Name
      • Synopsis
      • Description
      • Commands
      • Options
      • Fields
      • Name
      • Synopsis
      • Description
      • Commands
        • load
        • status
      • Options
      • Services
      • Name
      • Synopsis
      • Description
      • Options
      • Name
      • Synopsis
      • Description
      • Options
      • Name
      • Synopsis
      • Description
      • Commands
      • Options
      • Fields
      • Name
      • Synopsis
      • Description
      • Options
• Architecture
  • Component architecture
  • Protocol / Component Flow
    • Proxy capabilities
      • HAPROXY
      • NGINX
    • SMTP
      • Incoming
    • RPC/HTTP, MAPI/HTTP & EWS workflow
    • Exchange ActiveSync (EAS)
    • POP3
    • IMAP
    • Authentication
• Operations
  • Configuration
    • Admin API TLS configuration
    • Certificate management
  • Updating grommunio
    • Package Updates
  • Backup & Disaster Recovery
    • Database backup
    • File-based backup
  • Mail requeueing
  • Size limits
• Troubleshooting
  • Support package
  • Installation logs
  • System logs
  • Coredumps
• Release Notes
  • grommunio 2023.11.3
  • grommunio 2023.11.2
  • grommunio 2023.11.1
  • grommunio 2022.12.1
  • grommunio 2022.05.2
  • grommunio 2022.05.1
  • grommunio 2021.08.3
  • grommunio 2021.08.2
    • Post-update tasks
  • grommunio 2021.08.1
    • grommunio Admin API
      • New (Improvements)
      • Bugfixes
      • Removed
    • grommunio Admin Web
      • New (Improvements)
      • Bugfixes
      • Removed
    • grommunio CUI
      • New (Improvements)
      • Bugfixes
      • Removed
    • grommunio Core (gromox)
      • New (Improvements)
      • Bugfixes
      • Removed
    • grommunio Sync
      • New (Improvements)
      • Bugfixes
      • Removed
    • grommunio Setup
      • New (Improvements)
      • Bugfixes
      • Removed
    • grommunio Web
      • New (Improvements)
      • Bugfixes
      • Removed
• Roadmap
  • Release strategy
  • Disclaimer
• Legal Notice