Skip to main content

v4.3.6 to v4.3.8 migration guide

The Strapi v4.3.6 to v4.3.8 migration guide upgrades v4.3.6 to v4.3.8. The migration changes the SQLite database package from sqlite3 to better-sqlite3. The migration guide consists of:

  • upgrading the application dependencies,
  • changing the sqlite3 package to better-sqlite3,
  • reinitializing the application.
caution
  • This migration guide skips v4.3.7, which introduced an error in the SQLite database.
  • 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.

Upgrading the application dependencies​

✔︎ Prerequisites

Stop the server before starting the upgrade.

  1. Upgrade all of the Strapi packages in package.json to 4.3.8:
path: ./package.json

{
  // ...
  "dependencies": {
    "@strapi/strapi": "4.3.8",
    "@strapi/plugin-users-permissions": "4.3.8",
    "@strapi/plugin-i18n": "4.3.8",
    // ...
  }
}
  1. Change the sqlite3 package to better-sqlite3 version 7.4.6 in package.json:
path: ./package.json

{
  // ...
  "dependencies": {
    "@strapi/strapi": "4.3.8",
    "@strapi/plugin-users-permissions": "4.3.8",
    "@strapi/plugin-i18n": "4.3.8",
    "better-sqlite3": "7.4.6"
    // ...
  }
}

  1. Save the edited package.json file.

  2. Install the upgraded version:

    yarn
    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.

Rebuilding the application​

Run the following command in your project root directory:

yarn build

Restarting the application​

Run the following command in your project root directory:

yarn develop