phpGroupware Tutorial: phpGroupware Installation

How to install phpGroupware on your website?

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

Step 1: Download the installation file from phpGroupware downloads page. 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, 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 PHPGroupWare. Please, learn how to create a MySQL database and user here.

Step 5: Change the file permissions for the PHPGroupWare installation directory to 755 through cPanel->File Manager

Step 6: Navigate to the web address of your PHPGroupWare installation. There you can set up the installation of the script.

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 admin password. You can leave the next nine fields unchanged, since these are the default values for them. Then you should set the database name, the database user and the password. You should use the ones, which you have used in point 4.2.4. of the installation instructions. Once it is completed you should set the password for the configuration user. The last step is to write the configuration and continue to the setup section.

Step 7: 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 8: Once you login with the Config Admin details, you will be able to setup the applications, included in the script.

Step 9: Install the applications and then recheck the installation.

Step 10: Navigate to the Configuration section.

In this section you should only specify the absolute path to a folder, called files, which should be created through your File Manager in the root folder of your account. It 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 path will be:

/home/user/files

Then you can leave the default values of the other variables, since they are already set by the script installation. However, if you are familiar with the script functionality and you need a change in the values, you can proceed. At the end you should click on the "Save" button to write the configuration.

Step 11: You can create the administrator user by clicking on the "Click Here to setup an admin account and (optionally) 3 demo accounts" link. 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 and to manage the installed script applications.