diff --git a/docs/3.x.x/migration-guide/README.md b/docs/3.x.x/migration-guide/README.md index 000a49d734..c46bbaed4d 100644 --- a/docs/3.x.x/migration-guide/README.md +++ b/docs/3.x.x/migration-guide/README.md @@ -22,6 +22,6 @@ - [Migration guide from alpha.14.4 to alpha.14.5](migration-guide-alpha.14.4-to-alpha.14.5.md) - [Migration guide from alpha.14.5 to alpha.15](migration-guide-alpha.14.5-to-alpha.15.md) - [Migration guide from alpha.15 to alpha.16](migration-guide-alpha.15-to-alpha.16.md) -- [Migration guide from alpha.15 to alpha.16](migration-guide-alpha.15-to-alpha.16.md) - [Migration guide from alpha.16 to alpha.17](migration-guide-alpha.16-to-alpha.17.md) - [Migration guide from alpha.17 to alpha.18](migration-guide-alpha.17-to-alpha.18.md) +- [Migration guide from alpha.18 to alpha.19](migration-guide-alpha.18-to-alpha.19.md) diff --git a/docs/3.x.x/migration-guide/migration-guide-alpha.18-to-alpha.19.md b/docs/3.x.x/migration-guide/migration-guide-alpha.18-to-alpha.19.md new file mode 100644 index 0000000000..b563b8d941 --- /dev/null +++ b/docs/3.x.x/migration-guide/migration-guide-alpha.18-to-alpha.19.md @@ -0,0 +1,76 @@ +# Migration guide from alpha.18 to alpha.19 + +**Here are the major changes:** + +- Fix CLI database issue for Windows +- Custom timestamp +- Fix write file on production environment + +**Useful links:** +- Changelog: [https://github.com/strapi/strapi/releases/tag/v3.0.0-alpha.19](https://github.com/strapi/strapi/releases/tag/v3.0.0-alpha.19) +- GitHub diff: [https://github.com/strapi/strapi/compare/v3.0.0-alpha.18...v3.0.0-alpha.19](https://github.com/strapi/strapi/compare/v3.0.0-alpha.18...v3.0.0-alpha.19) + +
+ +::: note +Feel free to [join us on Slack](http://slack.strapi.io) and ask questions about the migration process. +::: + +
+ +## Getting started + +Install Strapi `alpha.19` globally on your computer. To do so run `npm install strapi@3.0.0-alpha.19 -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.19` version) of your project. + +Run `npm install strapi@3.0.0-alpha.19 --save` to update your strapi version. + +
+ +## Update the Admin + +::: note +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 + +::: note +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. + +## Production environment + +If you deploy your application on a server that you don't have write file access you will have to update your procution config file. +In `config/environments/production/server.json` file you have to add `production` key with `true` as value. + +``` +{ + ... + "port": "${process.env.PORT || 1337}", + "production": true, + "proxy": { + "enabled": false + }, + ... +} +``` + +
+ +That's all, you have now upgraded to Strapi `alpha.19`.