eGroupware Tutorial: eGroupware Installation

How to install eGroupware on your website?

You can install eGroupware software by following these Step-by-step instructions:

Step 1: Download the installation file from Egroupware Downloads page by clicking on "Follow this link to download the latest stable release". You should choose the platform independent release in tar.gz, tar or zip format. Then you will have the latest stable release of the script in your computer.

Step 2: Upload it in public_html folder of your account. You can do that through FTP with a client like FileZilla or through cPanel->File Manager->Upload file(s). In the second way, after the installation is completed, the file script will show if you go to the main page of your site (www.YourDomain.com). You can also install eGroupware in a subfolder - simply upload the installation file in the folder: public_html/subfolder. The eGroupWare installation will then be accessible at: www.yourdomain.com/subfolder.

Step 3: When you are in cPanel->File Manager, please navigate to the uploaded file and extract it by clicking on "Extract File Contents". Another option is to extract the files on your local computer and then upload them in the desired folder through FTP.

Step 4: Once the files are extracted in the desired folder, you should create a MySQL database for eGroupWare. Please, learn how to create a MySQL database and user here.

Step 5: You should open the .htaccess file from the installation directory and comment all the lines, which start with PHP_value. You should put the sign "#" in front of them. Then you should take these variables and copy then in a newly created file, called PHP.ini. The content of the PHP.ini file should be:

memory_limit = 32M
max_execution_time = 60
register_globals = Off
magic_quotes_gpc = Off
magic_quotes_runtime = Off
upload_max_filesize = 16M
session.use_trans_sid = Off
session.gc_probability = 1
session.gc_divisor = 10
mbstring.func_overload = 7

Then you should copy this file under every subfolder of the eGroupWare installation directory.

Step 6: Change the file permissions for the eGroupWare installation directory to 755 through cPanel->File Manager.

Step 7: Navigate to the web address of your eGroupWare installation and run the installation tests. Once they are completed you should navigate back to "Setup Main Menu" and click on "Skip the installation tests (not recommended)". However, if there is a problem, which occurs during the tests and you can not fix it, please post a ticket from your Customer Area->Get support->Post & Review tickets->Add new ticket. Then a member of our Technical Support Team will assist you with the installation of the script.

Step 8: Now you are ready to set up the primary configuration of your eGroupWare script installation.

The first two variables (Server Root and Include Root) are automatically set by the script and you should not change them unless you know what you are doing. Then you should set the login details for the admin user for the header manager. This user has the rights to change the primary configuration of the script after the installation is completed. The next field allows limiting the access to the setup to desired IP addresses or hostnames. You can leave the next nine fields unchanged, since they contain default values. Then you should set the database name, the database user and the password. You should use the ones, which you have set in Step 4 from the installation instructions. Once it is completed you should set the login details for the configuration user. The last step is to write the configuration and continue to the setup section.

Step 9: In the setup section you can reconfigure the script through the "Header Admin Login" or to setup the script through the "Config Admin Login".

Step 10: Once you login with the configuration login details, you will be able to setup your applications, included in the script.

First you can select the desired char-set for your database. Then you should install the applications. After this recheck the installations.

Step 11: Navigate to step2 and edit the current configuration of the script applications, which you have installed:

In the path information section you should specify the absolute paths to two folders, called files and backup, which should be created through your File Manager in the root folder of your account. They should be on the same level as the public_html folder. If the user of your account is "user" (the one, which you use to log in your cPanel), then the absolute paths will be:

/home/user/files

and

/home/user/backup

You can leave the Host Information unchanged, since it is automatically configured by the script. However, if you install the script outside the account, which you have with SiteGround, you could edit this section.

The Standard e-mail server settings would look like the following ones:

POP/IMAP mail server hostname or IP address: mail.yourdomain.com
Mail server protocol: IMAP or POP-3
Mail server login type: standard (login-name identical to the eGroupWare username)
Mail domain (for Virtual mail manager):
SMTP server hostname or IP address: mail.yourdomain.com
SMTP server port: 25
User for the SMTP authentication (leave it empty if no auth required): emailuser@yourdomain.com
Password for the SMTP-authentication: the corresponding password, which you have set during the creation of the e-mail account in cPanel->Mail->Manage/Add/Remove accounts.

Troubleshooting Tips: Please mind that you should change yourdomain.com with the actual domain, which you have used in Step 2 of the installation instructions. You should also change emailuser@yourdomain.com with an existing e-mail account, which you have created through cPanel->Mail->Manage/Add/Remove accounts.

You can leave the rest of the fields with their default values and navigate to the "Save" button. In this way you have completed the setup of your script. Now you should create an administrator user for it.

Step 12: You can create the administrator user by clicking on "Create admin account button". Once you are ready, you can navigate to the main URL of your eGroupWare installation. You have successfully completed the installation procedure.

The other options in the setup part allow you to change the default language, to manage the installed applications, which are included in the script, to add new applications or uninstall existing, to create and restore backups of your script installation.