Tutorial: How to Install egroupware on Debian Latest

Egroupware is a web-based groupware suite that enables users to manage and collaborate on projects, documents, contacts, time-tracking, and more. In this tutorial, we will be installing egroupware on Debian Latest.

Prerequisites

  • A Debian Latest server with root access or a non-root user account with sudo privileges.
  • A web server, such as Apache or Nginx.
  • PHP 7.2 or higher, including the required PHP extensions.
  • A MySQL or MariaDB database server.

Step 1: Install Required Dependencies

Before installing egroupware, ensure that your server has the required dependencies installed. Run the following command to install the necessary packages:

sudo apt-get update
sudo apt-get install apache2 mariadb-server php7.4 libapache2-mod-php7.4 php7.4-cli php7.4-gd php7.4-curl php7.4-mbstring php7.4-ldap php7.4-mysql php7.4-xml php7.4-zip

Step 2: Download Egroupware

Next, we will download Egroupware from the official website. Run the following commands to download and extract the latest version of Egroupware:

cd /tmp
wget https://github.com/EGroupware/egroupware/archive/refs/tags/21.1.20211023.tar.gz
tar -xzvf 21.1.20211023.tar.gz

Step 3: Install Egroupware

After downloading Egroupware, we will move it to the web server root directory and set the correct permissions.

sudo mv egroupware-21.1.20211023 /var/www/html/egroupware
sudo chown -R www-data:www-data /var/www/html/egroupware
sudo chmod -R 755 /var/www/html/egroupware

Step 4: Configure Egroupware

Egroupware comes with a configuration file that needs to be copied to the /etc directory. Run the following command to copy the file:

sudo cp /var/www/html/egroupware/header.inc.php /etc/egroupware-docker/header.inc.php

Next, we will create a new virtual host file for Egroupware. Run the following command to create the file:

sudo nano /etc/apache2/sites-available/egroupware.conf

Add the following content to the file:

<VirtualHost *:80>
     ServerAdmin [email protected]
     DocumentRoot /var/www/html/egroupware
     ServerName example.com
     ErrorLog ${APACHE_LOG_DIR}/error.log
     CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>

Replace "ServerAdmin" and "ServerName" with your email address and domain name.

Save and close the file.

Enable the new virtual host by running the following command:

sudo a2ensite egroupware.conf

Restart the Apache service to apply the changes:

sudo systemctl restart apache2

Step 5: Install Egroupware Database

Finally, we will create a new MySQL/MariaDB database and user for egroupware.

Login to MySQL/MariaDB using the root account:

sudo mysql -u root -p

Create a new database and user for Egroupware:

CREATE DATABASE egroupware;
CREATE USER 'egroupwareuser'@'localhost' IDENTIFIED BY 'your_password';
GRANT ALL PRIVILEGES ON egroupware.* TO 'egroupwareuser'@'localhost';
FLUSH PRIVILEGES;
exit;

Replace 'your_password' with your desired password.

Step 6: Finish Egroupware Setup

Open your web browser and navigate to http://example.com/setup/. Replace example.com with your server's domain name.

The Egroupware setup wizard will guide you through the installation process. Enter the database details that you created in Step 5 and follow the on-screen instructions.

After completing the setup, you can access Egroupware by navigating to http://example.com/egroupware/.

Congratulations! You have successfully installed Egroupware on Debian Latest. You can now start using it to manage your projects, contacts, documents, and more.