Upgrading ActiveCollab

Starting from version 5.5, ActiveCollab can be updated automatically from the System Settings. Whenever the button New Update Available appears, click it to apply the latest update.

Upgrading Manually #

If you're having issues with the automatic upgrade or your server has limited internet connectivity, you can also upgrade ActiveCollab manually:


Open the command line and cd to the /tasks folder on your server.


Run this command:

php activecollab-cli.php upgrade

Delete everything (except the .htaccess file, if you have it) inside the /compile and /cache folders.

Upgrading from ActiveCollab 4 #

Upgrading the self-hosted version isn’t direct or automatic, but it's not too complicated. You'll have to set up the new ActiveCollab separately from your existing installation - and then import the data. Just make sure they're both on the same server.

The good part is you can have both versions running side by side. That means you'll still be able to use your old ActiveCollab while you're installing and testing the new version.

If you have ActiveCollab v3 or earlier, you first need to upgrade to v4 and then to v5.

Keep a few things in mind:

  • You can only move your data to the new version (and not vice versa).
  • Partial migration is not possible (eg. having only some projects moved to the new version).

Make sure you're running ActiveCollab 4.2.17 or later (learn more).


Do a clean install of ActiveCollab 5 to a separate location (here's how).


Check that the AC5 database user has permissions to the AC4 database as well.


SSH to your server, navigate to the /tasks folder of your ActiveCollab 5, make sure that config.php is writable, and run this command:

php activecollab-cli.php clone_legacy_data /path/to/activecollab-4/config/config.php

To rebuild the activity logs, run this command:

php activecollab-cli.php rebuild_activity_logs

To rebuild the search index, run this command:

php activecollab-cli.php rebuild_search_index

Steps #3, #4 and #5 can take a while, especially if your ActiveCollab 4 has a lot of data.

After you've upgraded, head off to the ActiveCollab 5 login page, and enter your ActiveCollab 4 username and password. All your projects should be there and you'll be able to continue where you left off.

Upgrade Errors

If you’re having trouble, it’s possible you have more than one PHP extension installed on the server (eg. php, php5, phpcli).

It's possible your PHP is not CLI or the version is lower than PHP 5.6.:

  • to check the version, run php -v (or php5 -v depending on the name of extension).
  • find all the extensions by running whereis php

If no PHP extension on your server meets the requirements, you’ll need to install it before the upgrade.

If you find a PHP extension (CLI + PHP5.6) that's called php-cli (eg. under usr/local/bin/), then you’ll need to run the upgrade this way:

usr/local/bin/php-cli activecollab-cli.php clone_legacy_data /path/to/activecollab-4/config/config.php

If you're having difficulties, reach out to support@activecollab.com and we'll help you out.