Migration guide from alpha.24 to alpha.25.2

Here are the major changes:

• Getting started videos helper in the admin
• New getting started

Useful links:

• Changelog: https://github.com/strapi/strapi/releases/tag/v3.0.0-alpha.25.2 (opens new window)
• GitHub diff: https://github.com/strapi/strapi/compare/v3.0.0-alpha.24...v3.0.0-alpha.25.2 (opens new window)

TIP

Feel free to join us on Slack (opens new window) and ask questions about the migration process.

Getting started

Install Strapi alpha.25.2 globally on your computer. To do so run npm install strapi@3.0.0-alpha.25.2 -g.

When it's done, generate a new empty project strapi new myNewProject (don't pay attention to the database configuration).

Update node modules

Update the Strapi's dependencies version (move Strapi's dependencies to 3.0.0-alpha.25.2 version) of your project.

Run npm install strapi@3.0.0-alpha.25.2 --save to update your strapi version.

Update the Admin

TIP

If you performed updates in the Admin, you will have to manually migrate your changes.

Delete your old admin folder and replace it with the new one.

Update the Plugins

TIP

If you did a custom update on one of the plugins, you will have to manually migrate your update.

Copy the fields and relations you had in your /plugins/users-permissions/models/User.settings.json and /plugins/users-permissions/config/jwt.json file in the new one.

Then, delete your old plugins folder and replace it with the new one.

Update Mongoose

Update all your API services by following this update https://github.com/strapi/strapi/pull/2812/files#diff-c36b911d1bc2922e1d7cf93ae692e054R132 (opens new window)

Update Bookshelf

Update all your API services by following this update https://github.com/strapi/strapi/pull/2970/files#diff-61ba361ed6161efcd5f4e583001cc9c9R240 (opens new window) and https://github.com/strapi/strapi/pull/2864/files#diff-61ba361ed6161efcd5f4e583001cc9c9R124 (opens new window)

We update the name of the life cycle for the before/after fetch all https://github.com/strapi/strapi/pull/2965/files (opens new window) You will have to replace beforeFetchCollection by beforeFetchAll if you added theses functions in you Model.js files.

That's all, you have now upgraded to Strapi alpha.25.2.