# Migration guide from alpha.15 to alpha.16

Here are the major changes:

  • Fix Relations on filter

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

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

Reverse of migration alpha.14.5 to alpha.15 Bookshelf section.

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)

Reverse of migration alpha.14.5 to alpha.15 Mongoose section.

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.


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