# Migration guide from alpha.14.5 to alpha.15

Here are the major changes:

  • Relations on filter
  • Update provider prefix
  • Fix proxy for authentication providers

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.15 globally on your computer. To do so run npm install strapi@3.0.0-alpha.15 -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.15 version) of your project.

Run npm install strapi@3.0.0-alpha.15 --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.

# ⚠️ Bookshelf (Postgres and MySQL)

Go in diff files (opens new window) and search for following files:

Services: packages/strapi-generate-api/templates/bookshelf/service.template

Life cycle: packages/strapi-generate-model/templates/bookshelf/model.template

You will have to update all your service by applying the diff.


# ⚠️ Mongoose (Mongo)

Go in diff files (opens new window) and search for following files:

Service: packages/strapi-generate-api/templates/mongoose/service.template

You will have to update all your service by applying the diff.


# Providers

Like hook, middleware and plugin - we prefix plugin provider with provider Format: strapi-provider-[plugin_name]-[provider]

eg. strapi-email-sendmail become strapi-provider-email-sendmail

We still support the old format for next version to let time to providers maintainers to make migration.


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