# 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:


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