Installation

Note: This article is about the self-hosted version of Active Collab. If you're using the cloud, everything is set up so you can start working right away.

Creating a Database #

The installer doesn't create a database, so make sure you have one available. You can use MySQL administration tools (eg. phpMyAdmin) or contact your administrator to create a database for you.

You'll need the following details during the installation:

  • The database host name (usually "localhost"), as well as the username and password.
  • The name of the newly created database.

Installation #

1

Log in to My Active Collab with the license email.

2

Download the installation package.

3

Unpack the archive and upload the files to a folder on your web server.

4

Type the path of your Active Collab 5 folder on the server to start the installer (the location of the folder on your server where you uploaded AC files in the previous step, eg. www.yoursite.com/projects).

nginx URL Rewriting

nginx rewrite rules:

if (!-e $request_filename) {
  rewrite ^/assets/(.*)$ /assets/$1 last;
  rewrite ^/avatars/(.*)$ /avatars/$1 last;
  rewrite ^/wallpapers/(.*)$ /wallpapers/$1 last;
  rewrite ^/verify-existence$ /verify.php last;
  rewrite ^/proxy.php$ /proxy.php last;
  rewrite ^/api/v([0-9]*)/(.*)$ /api.php?path_info=$2&api_version=$1 last;
  rewrite ^$ /router.php last;
  rewrite ^(.*) /router.php?path_info=$1 last;
}
5

Active Collab first checks if your server meets the requirements. Green means "OK", orange means "OK, but could be better" and red shows errors you need to fix before proceeding.

6

The installer then collects MySQL connection parameters, and validates that Active Collab can connect to the database.

7

Finally, Active Collab collects the license owner information and completes the installation.

If any of the above validation steps fail, error messages will tell you what needs to be fixed before you can proceed. If you need help, get in touch by sending us an email.

Importing Trial Data #

1

Contact support@activecollab.com and request a backup of your data.

2

Open the archive file and upload the content to the respective directories in your Active Collab setup (overwrite the existing files).

3

Delete all the tables from the database and import the data from .sql file in the archive.

4

Delete all .php files in the /cache directory.

5

Delete all .php files in the /compile directory.

You should then be able to see all the trial projects and users in your self-hosted Active Collab.

Note

Partial import (eg. copying just some projects) is not possible. You can only import everything from the free trial at once - and it will overwrite any existing data in the self-hosted Active Collab.

After you're finished with the installation, you need to configure Cron Jobs, Document Search (optional, if you want to use search), and mailing.

Moving to Another Server #

Before moving, make sure the new server meets the minimum system requirements.

1

Install Active Collab 5 on the new server.

2

Import the database from the old server.

3

Copy the Upload folder from the old server to the new server (overwrite it).

4

Change Application Key in the config.php (enter the key from the old server).

5

Empty Compile and Cache folders.