Upgrading DX8

    If you have installed the dx8_deployment module and are upgrading to version 5.0 from an earlier version, you will need to uninstall it before updating to the latest version of DX8 as the dx8_deployment module is no longer included within newer releases of DX8.

    When upgrading your website to the latest version of DX8, database updates will be applied and therefore you can't roll back to the previous version of DX8 once upgraded.

    We recommend applying updates on your development environment and backing up your website including your database before upgrading DX8.

    You can upgrade the DX8 module using composer or manually. 

    Step 1a - Upgrade using composer

    Using composer is the preferred way to upgrade DX8. 
    It is not recommended to manually edit the composer.json file.

    Open your terminal and browse to the directory containing your project root directory. Run the following command, updating the version number to the version you want to update too:

    composer require cohesion/dx8:5.4.0
    composer require cohesion/dx8-theme:5.4.0

    Next run composer update command in your terminal:

    composer update

    This will then update your DX8 module and DX8 minimal theme to the new version you have set.

    Step 1b - Upgrade manually

    Upgrade DX8 module

    Navigate to the download page for the module: https://bitbucket.org/cohesion_dev/dx8-module/downloads/?tab=tags and click "zip" "gz" or "bz2" on the top entry to download the DX8 module. 

    Once the file has downloaded, unzip it, rename the folder to "dx8" and then copy to your /modules/contrib/ directory of project. When prompted click "replace" to replace your older version of DX8 with the new one you just downloaded.

    Upgrade DX8 minimal theme

    Navigate to the download page for the theme: https://bitbucket.org/cohesion_dev/dx8-theme/downloads/?tab=tags and click "zip", "gz" or "bz2" on the top entry to download the theme. 

    Once the file has downloaded, unzip it, rename the folder to "dx8-theme" and then copy to your /themes/contrib/ directory of project. When prompted click "replace" to replace your older version of the DX8 minimal theme with the new one you just downloaded.

    Step 2 - Run drush commands

    Next you will need to run a few drush commands, open up your terminal and browse to your project root directory. 

    First you should clear your website cache.

    drush cr

    Then you will need to do an entity update. This will update entity type schemas.

    drush entup -y

    Next, you will need to do a database update. This will apply database updates to your Drupal site that the new version may require.

    drush updb -y

    Then finally you will need to do a DX8 import and rebuild. 

    Using drush 9:

    drush dx8:import
    drush dx8:rebuild

    Using an earlier version of drush:

    drush dx8 import
    drush dx8 rebuild


    Once DX8 has finished running the import and rebuild, your DX8 version will now be up to date with the version you downloaded. 

    Cohesion DX8 Help center

    Launch our Help center to raise a support ticket or search our knowledge base of common questions and answers.

    DX8 knowledge base icon

    Knowledge base

    Get instant answers to common questions. Available online 24/7.

    Find answers

    Raise a ticket icon

    Raise a support ticket

    Log in to the Help center to raise an issue. Available Monday - Friday, 09:00 - 17:00 GMT.

    Raise ticket