The eGroupware suite provides a group of server-based applications that offer collaboration and enterprise-targeted tools to help enable communication and information sharing between teams and institutions. These tools are tightly coupled and allow users to take advantage of data from one system, like the address book, and make use of it in other systems, including the calendar, CRM, and email systems. eGroupware is designed to be flexible and adaptable, and is capable of scaling to meet the demands of a diverse class of enterprise needs and work groups, all without the need to rely on a third-party vendor. As eGroupware provides its applications entirely independent of any third party service, the suite is a good option for organizations who need web-based groupware solutions, but do not want to rely on a third party provider for these services.
Before installing eGroupware we assume that you have followed our getting started guide. If you're new to Linux server administration, you may be interested in our using Linux document series as well as our beginner's guide and administration basics guide. Additionally, you will need install a LAMP stack as a prerequisite for installing eGroupware. You may also want to use eGroupware to help manage email, and will need to have a running email system. Consider running Postfix with Courier and MySQL.
Make sure your package repositories and installed programs are up to date by issuing the following commands:
apt-get update apt-get upgrade --show-upgraded
In this guide we will be installing eGroupware from the packages provided by the Debian project. Although there are some slightly more contemporary versions of eGroupware available from upstream sources, we've chosen to install using this method in an effort to ensure greater stability, easy upgrade paths, and a more straight forward installation process. Begin the installation by issuing the following command:
apt-get install egroupware
During the installation process, an interactive "package configuration" is provided by Debian's debconf system. This provides a URL to access the setup utility after you've finished the installation process. Make note of the URL, the form is http://ducklington/egroupware/setup/ where ducklington is the hostname of the system. Continue with the installation process.
The debconf process creates an administrator account, which it allows you to specify at this time. By default this eGroupware username is "admin." Change the username, if you like, and create a password as instructed. When this process is complete, the installation process is finished. You will also want to issue the following commands to install additional dependencies and resolve several minor issues with the distribution package in order:
pear install Auth_SASL rm /usr/share/egroupware/etemplate/doc cp -R /usr/share/doc/egroupware-etemplate/ /usr/share/egroupware/etemplate/doc rm /usr/share/egroupware/sitemgr/doc cp -R /usr/share/doc/egroupware-sitemgr/ /usr/share/egroupware/sitemgr/doc
Congratulations, you've now installed eGroupware!
If you do not have any virtual hosts enabled and your domain is ducklington.org, you should be able to visit http://ducklington.org/egroupware/setup to access the remainder of the eGroupware setup provided that ducklington.org points to the IP of your server. However, if you have virtual hosting setup, you will need to issue the following command to create a symbolic link to eGroupware:
ln -s /usr/share/egroupware/ /srv/www/ducklington.org/public_html/egroupware
Replace /srv/ducklington.org/public_html/ with the path to your virtual host's DocumentRoot, or other location within the DocumentRoot where you want eGroupware to be located. Then, visit http://ducklington.org/egroupware/setup/ to complete the setup process. You will be prompted for a password then brought to a configuration interface. Review the settings and modify them to reflect the specifics of your deployment, particularly the database settings. Do not forget to create an administrative user for the database instance you are creating. When you have completed the eGroupware configuration, select the "'Write' Configuration file" option. Continue to the "Login" page.
When you have completed the initial "Header Setup," select the option to write the "header" file and then continue to the "Setup/Admin." Ensure that you've selected the correct "Domain" if you configured more than one. At this juncture you must install the eGroupware applications that you will expect to use. Select the proper character set and select the button to "'Install' all applications." You can now "Recheck" your installation. Supply eGroupware with the configuration for your email server. Additionally, you will need to create an admin account for your eGroupware domain, which you can accomplish from this page.
When all applications have been installed, you will be provided with a number of options that you can use to fine-tune the operations and behavior of your eGroupware instance. You've now successfully installed and configured eGroupware!
You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.
This guide is licensed under a Creative Commons Attribution-NoDerivs 3.0 United States License.
Last edited by Amanda Folson on Monday, August 22nd, 2011 (r2428).