How to Install and Configure EGroupware Community Edition EGroupware is a powerful, enterprise-grade open-source collaboration suite. It integrates toolsets like calendars, address books, file management, and project tracking into a single web interface. The Community Edition offers a self-hosted, cost-effective solution for teams looking to maintain full control over their data.
This guide provides a step-by-step walkthrough for installing and configuring EGroupware Community Edition on a clean Ubuntu server using the recommended Docker-based installation method. Prerequisites
Before starting, ensure your system meets the following requirements:
Operating System: Ubuntu 22.04 LTS or 24.04 LTS (Clean installation recommended)
CPU/RAM: Minimum 2 Cores, 4 GB RAM (8 GB recommended for active teams)
Domain Name: A fully qualified domain name (FQDN) pointed to your server’s public IP address
Network Ports: Open ports 80 (HTTP) and 443 (HTTPS) in your firewall Step 1: Update the System
Log into your server via SSH as the root user or a user with sudo privileges. Begin by updating the local package index and upgrading existing packages to their latest versions. sudo apt update && sudo apt upgrade -y Use code with caution. Step 2: Install Docker and Docker Compose
EGroupware Community Edition is officially distributed and maintained via Docker containers. This approach simplifies dependency management and ensures smooth updates. Install required prerequisite packages:
sudo apt install -y curl apt-transport-https ca-certificates gnupg lsb-release Use code with caution. Add the official Docker GPG key:
sudo mkdir -p /etc/apt/keyrings curl -fsSL https://docker.com | sudo gpg –dearmor -o /etc/apt/keyrings/docker.gpg Use code with caution. Set up the Docker repository:
echo “deb [arch=\((dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://docker.com \)(lsb_release -cs) stable” | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null Use code with caution. Install the Docker engine and Docker Compose plugin:
sudo apt update sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin Use code with caution. Verify that Docker is running: sudo systemctl status docker Use code with caution. Step 3: Install EGroupware via the Official Repository
EGroupware provides a native package wrapper that automates the Docker deployment, configures an Nginx reverse proxy, and handles initial database provisioning. Add the EGroupware repository key:
curl -fsSL https://opensuse.org(lsb_release -rs)/Release.key | sudo gpg –dearmor -o /etc/apt/keyrings/egroupware.gpg Use code with caution. Add the EGroupware repository to your system sources:
echo “deb [signed-by=/etc/apt/keyrings/egroupware.gpg] https://opensuse.org(lsb_release -rs)/ /” | sudo tee /etc/apt/sources.list.d/egroupware.list Use code with caution. Update the package lists and install EGroupware: sudo apt update sudo apt install -y egroupware-docker Use code with caution.
During the installation process, a prompt will appear asking you to configure the default mail server domain and database parameters. If you are using an external database or mail system, fill these out accordingly; otherwise, press Enter to accept the secure automatic defaults. Step 4: Configure Let’s Encrypt SSL Certificate
Securing your collaboration platform with HTTPS is mandatory for modern web browsers and mobile synchronization. Install Certbot for Nginx: sudo apt install -y certbot python3-certbot-nginx Use code with caution.
Generate the SSL certificate (replace ://yourdomain.com with your actual domain): sudo certbot –nginx -d ://yourdomain.com Use code with caution.
Follow the on-screen prompts to enter your email address and agree to the terms of service. Certbot will automatically modify your Nginx configuration to enforce HTTPS traffic. Step 5: Initial Setup and Configuration
Once the installation finishes and the Docker containers are healthy, you can access the EGroupware setup wizard via your web browser. Navigate to: https://yourdomain.com
Define Setup Password: On your first visit, you will be prompted to create a master “Setup Password”. This password protects the underlying database configuration panel.
Manage Header Admin: Log in using your newly created setup password. Here, you can configure your primary database credentials, system paths, and backup schedules.
Create Domain and Admin User: Click on Create Admin Account. Follow the prompts to create your primary enterprise domain (usually “default”) and build your first super-administrator user account. Step 6: Accessing the User Interface
With the installation completed, navigate to the main application URL:
Leave a Reply