---
title: "Upgrading Drupal core to the latest version of 10.x for Acquia CMS"
date: "2024-04-10T01:46:36+00:00"
summary: "Upgrade Acquia CMS 2.x to Drupal 10: Step-by-step guide for CKEditor 5 migration and core update. Improve your site today!"
image:
type: "page"
url: "/drupal-starter-kits/upgrading-drupal-core-latest-version-10x-acquia-cms"
id: "5c6b3d31-dedb-4c02-9a82-6b5b1e31c8f3"
---

Important

The instructions set out here are the **third** in the [**overall process of upgrading Acquia CMS**](/drupal-starter-kits/upgrading-drupal-starter-kits-and-its-dependencies "Upgrading Drupal Starter Kits and its dependencies") from 1.x to 2.x of **three** **stages**.

Ensure that you have performed the [**first stage**](/drupal-starter-kits/upgrading-acquia-cms-1x-its-current-version-latest-version "Upgrading Acquia CMS 1.x from its current version to the latest version ") and [**second stage**](/drupal-starter-kits/upgrading-acquia-cms-1x-2x "Upgrading Acquia CMS from 1.x to 2.x") before you perform these steps!

The overall process to upgrade Acquia CMS **2.x** to the latest Drupal 10 version involves:

*   update the text format to use CKEditor 5,
*   updating CKEditor to version 5,
*   removing unnecessary modules,
*   upgrading Drupal to the latest version of 10.x

Important

The instructions on this page assume that you have installed `drush` as part of your Drupal codebase, and so is shown running from `./vendor/bin/drush`, relative to your application's project directory.

Steps to upgrade
----------------

Important

The following steps are written so as to be performed in your **local development site** first!

1.  Switch from **CKEditor 4** to **CKEditor 5**.
    1.  Install the CKEditor 5 module with the following command:
        
            ./vendor/bin/drush en ckeditor5
        
    2.  Click **Configuration** > **Content authoring** > **Text formats and editors**.
        
        Alternatively, append `/admin/config/content/formats` to your application name.
        
    3.  Update each text format, such as Filtered HTML and Full HTML, to use CKEditor 5.
        
        For more information, see [Using the CKEditor5 text editor for the “Site Studio” text format.](/drupal-starter-kits/integrating-acquia-dam-drupal-starter-kits "Integrating Acquia DAM with Drupal Starter Kits")
        
    4.  Uninstall any previous version of the CKEditor module.
        
            ./vendor/bin/drush pmu ckeditor
            
            ./vendor/bin/drush cex
        
    5.  Commit all changes, deploy them to your development environment, and run the following commands:
        
            ./vendor/bin/drush cr
            
            ./vendor/bin/drush cim --yes
            
            ./vendor/bin/drush updb --yes
        
    6.  Verify that the site in your development environment works as expected.
2.  Upgrade your Drupal core version.
    1.  Remove incompatible and insignificant modules.
        
            composer remove drupal/upgrade_status
            
            Composer remove acquia/http-hmac-php
        
    2.  Add the HAL module to the codebase because it is removed from Drupal core 10.
        
            composer require 'drupal/hal:^2.0'  --no-update --no-install
        
    3.  Add the latest version of core and contrib module.
        
        You can remove modules that are not used in the project. For example, [Webform](https://www.drupal.org/project/webform) and [Google Analytics](https://www.drupal.org/project/google_analytics).
        
            composer require "drupal/core-composer-scaffold:^10" "drupal/core-recommended:^10" drupal/webform:^6 drupal/google_analytics:^4 drush/drush:^12 --no-update --no-install
        
    4.  Install the latest Drupal core and its required dependencies with the following command:
        
            composer update -W
        
    5.  Perform post upgrade activities.
        
            ./vendor/bin/drush cr
            ./vendor/bin/drush updb -y
            
            ./vendor/bin/drush cex
            ./vendor/bin/drush coh:import
            
            ./vendor/bin/drush coh:rebuild
        
    6.  **Commit** all the changes, deploy them to your **Acquia development site**, and run the following commands:
        
            ./vendor/bin/drush cr
            
            ./vendor/bin/drush cim --yes
            
            ./vendor/bin/drush updb --yes
        
    7.  Verify that the site in your **Acquia development site** works as expected.