This important feature of trakked helps you to keep your Contao installations up to date. Learn everything you need to know about the updates in the following chapter.

Contao follows the concept of Semantic Versioning for version naming. Thus, Contao has three different release types. The major release from version 4 to 5, the minor release from version 4.9 to 4.13 and the bugfix release from 4.13.10 to 4.13.11. The update function of trakked is only suitable for bugfix releases, because for the other two types, manual actions (e.g. template adjustments) are required.


The update function can be found in various places in trakked. If you are in the detail view of an installation, use the "Update" tab. Additionally, there is the Update Cockpit for updates. In the following article, we will describe the update process via the Update Cockpit, as it is the fastest and recommended way.

Update Cockpit

In the Update Cockpit, trakked displays exactly the information that is important for the update process.

This allows you to see at a glance when the last update was performed for the respective installation. To avoid having to go through the detailed view of each installation, the list has been provided with its own action buttons.

You can use the Filter & Search feature to control the view as usual.

The multiple selection is also available for the update. To use it, click on the trakked logo for the desired installations and then on the action you wish to be performed.

Update Contao Manager

The same way Contao receives regular updates, so does the Contao Manager. trakked ensures that the Contao Manager is kept up to date. This ensures that you always run on the latest version and the additional effort of updating it manually is eliminated.

As soon as a new version of the Contao Manager is released, just wait for a night and the next morning the Contao Manager will be up to date for you.

Prepare update

To update your installation, the first step is to prepare the update. A test run of the update is carried out, at the end all packages or all package dependencies are displayed in the detail view of each installation, which are updated with a possible update.

To avoid any unpleasant surprises, we recommend that you check the individual changes to the packages before installing them.

Install update

After successful preparation, you can then decide whether you want to install the update or rather discard it.

Mark as completed

After the successful installation of an update, the installation must be marked as done respectively archived. If there are any open database migrations, this will also be indicated to you. More about this in the next section.

Before archiving, you can use the direct link to visit your website to check if you can find any discrepancies on the website or if it all went well.

Detect open database migrations

After the Contao update, trakked automatically checks in the background if database migrations are required, so that you do not have to open the Contao Manager every single time you update Contao. If open migrations are detected, an additional icon is displayed.

By the way, the check takes place regularly in the background and works independently of the update process. If you have forgotten to migrate the database when installing packages, the warning will always be displayed. Additionally, you will receive the warning also in our weekly email report. This way you can make sure that you never miss out on pending migrations and the database is always up to date.

Update history

To keep your documentation up to date and to make it easier for your customers to verify the updates you have performed, you can export the update history.

To do so, open the desired installation in the detail view and switch to "Updates". Here you click on the button "Update history" and find an "arrow icon" in the upper right corner to start the export. When the data is prepared, you can choose between Excel and CSV format. The formats differ only in the separator, where "comma" is used for CSV and "semicolon" for Excel.

The update history can also be opened in the Update Cockpit without detour via the detail view by clicking on "History".

Each log entry in the update history starts with a summary and then shows the individual steps. So you can immediately see if the Contao update was successful.

By the way, trakked automatically detects if packages have changed in your Contao installation. This can be caused by a manual update of Contao or by the installation or removal of an extension via the Contao Manager. This way, the update history is always up to date and you can precisely track which changes have been made during each individual installation.

Backup of composer.json and composer.lock

There is also a backup for the "composer.json" and the "composer.lock" available for you in the summary of the log entry. So if needed you can download older versions of the two files and import them on your server.

As of Contao 4.13, a backup of the database is automatically stored in the var/backups directory before any database migration.

Disable update feature

If you update your installations via a deployment tool, you can deactivate the update function for the installation in the Configuration tab under "Advanced settings". After deactivation, the "Updates" tab is no longer displayed.

Video

As soon as you click, data is downloaded from YouTube and thus your IP address is submitted to their servers. For more information on data protection regarding our newsletter, please visit our privacy policy.