# Upgrade Strapi version

Strapi periodically releases code improvements through upgrades. Upgrades contain no breaking changes and are announced in both the terminal and in the administration panel. Migration guides are provided whenever a new Strapi version includes breaking changes.

✋ CAUTION

Plugins extension that create custom code or modify existing code will need to be updated and compared to the changes in the repository. Not updating the plugin extensions could break the application.

# Step 1: Upgrade the dependencies

PREREQUISITES

  • Stop the server before starting the upgrade.
  • Confirm there are no migrations between the current and ultimate Strapi versions.
  1. Upgrade all of the Strapi packages version numbers in package.json to the latest stable Strapi version:

    // path: package.json
    
    {
      // ...
      "dependencies": {
        "@strapi/strapi": "4.5.3", 
        "@strapi/plugin-users-permissions": "4.5.3",
        "@strapi/plugin-i18n": "4.5.3",
        "better-sqlite3": "7.4.6"
        // ...
      }
    }
    
    
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
  2. Save the edited package.json file.

  3. Install the upgraded version:

💡 TIP

If the operation doesn't work, try removing your yarn.lock or package-lock.json. If that doesn't help, remove the node_modules folder as well and try again.

# Step 2: Rebuild the application

Rebuild the administration panel:

# Step 3: Start the application

Start the application and ensure that everything is working as expected: