Installation

activeCollab installation goes in six simple steps:

1. Making sure that your server meets System Requirements. If server does not meet them or it is not properly configured, you'll not be able to run installation tool
2. Creating a MySQL database where activeCollab will store the data. If you already have a database set up, this step is optional
3. Downloading activeCollab installation package and your license file from activeCollab website
4. Uploading content of /for-upload folder onto your server
5. Running the installer tool
6. Logging in for the first time and verifying that system is working properly

Please read on to learn more about each of these steps.

Before you continue with the installation, please make sure that your server meets activeCollab System Requirements. activeCollab works well on most platforms that have a web server with PHP support and MySQL database.

To easily test if your system meets system requirements, you can use probe.php script we designed just for that.

1. Download probe.php.zip file from this page
2. Unpack and upload probe.php file to your server
3. Run it using your web browser
4. Optionally, you can open probe.php in your favorite text editor and set database connection parameters in Database Settings sections at the beginning of the file. Once these parameters are set, save the file to the server and run it again. It will run platform check and additionally try to connect to the database and see if it meets system requirements

In action: probe.php

activeCollab installer will not created a database for you so please make sure that you have one for your activeCollab installation before continuing. If you don't have your own database, you can create it using your favorite MySQL administration tool (phpMyAdmin for instance) or contact your system administrator to create it for you:

Creating a new database using phpMyAdmin

When you're finished creating the database, you should note the following details:

• Database host name (it's usually "localhost"), database username, and password
• Name of the database that you have just created

activeCollab installer will ask for these details a little bit later and you'll not be able to perform the installation if you don't have them.

When installing activeCollab, you'll need to download two files from activeCollab.com website:

1. Installation package
2. License file

Both files are available in your activeCollab.com profile. To access them, log in with an account you used to purchase a license. When logged in, click on My Profile link in the top right corner of the page:

All your licenses (you can have more than one) will be listed on your profile page. Both installation package and license file download links are available in license details block:

Once you downloaded installation package, unpack it using your favorite ZIP utility. Inside of the main folder, you'll find following files and folders:

• /for-upload - activeCollab files that you'll need to upload to your server
• license.txt - activeCollab End User license agreement
• readme.txt - Basic information about the system and links to additional resources
• release-notes.txt - Information about current release and releases before it

You do not need to upload all the files to your server. Instead, you should upload just the content of /for-upload folder:

Now that you have uploaded files to your server, you can run activeCollab installer. Installer is a web tool that is executed with web browser. When you try to open any of activeCollab pages, system will display an information that it's not yet installed and offer you a link to installer tool.

Click on that link to open the installer:

Installer will ask you to provide:

1. License file you downloaded in step #3
2. Email address and password of administrator's account
3. Name of your company or organization
4. Database connection parameters you prepared in step #2
5. You acceptance of activeCollab License Agreement

Once installation is executed properly, system will display all OK messages and provide you with the link to the login form where you can use administrator email address and password to log in:

Now that you ran Installation tool and that you deleted /public/installer folder, visit your newly created activeCollab setup. If everything went well, system should provide a simple login screen where you can insert administrators login parameters you provided on installation:

If you don't see a login screen and see an error message or a blank page instead, please consult Troubleshooting guide and contact A51 support.