mirror of
https://github.com/strapi/strapi.git
synced 2025-08-11 02:07:51 +00:00
99 lines
2.6 KiB
Markdown
99 lines
2.6 KiB
Markdown
# Update Strapi version
|
|
|
|
With this guide you will know how to upgrade your application to the latest version of Strapi.<br>
|
|
Before you start make sure **your server is not running until the end** of the guide.
|
|
|
|
## Upgrade your dependencies
|
|
|
|
Start by upgrading all your Strapi packages in your `package.json`.<br>
|
|
For example upgrading from `3.2.4` to `3.2.5`:
|
|
|
|
:::: tabs
|
|
|
|
::: tab 3.2.4
|
|
|
|
```json
|
|
{
|
|
//...
|
|
"dependencies": {
|
|
"strapi": "3.2.4",
|
|
"strapi-admin": "3.2.4",
|
|
"strapi-connector-bookshelf": "3.2.4",
|
|
"strapi-plugin-content-manager": "3.2.4",
|
|
"strapi-plugin-content-type-builder": "3.2.4",
|
|
"strapi-plugin-email": "3.2.4",
|
|
"strapi-plugin-graphql": "3.2.4",
|
|
"strapi-plugin-upload": "3.2.4",
|
|
"strapi-plugin-users-permissions": "3.2.4",
|
|
"strapi-utils": "3.2.4"
|
|
//...
|
|
}
|
|
}
|
|
```
|
|
|
|
:::
|
|
|
|
::: tab 3.2.5
|
|
|
|
```json
|
|
{
|
|
//...
|
|
"dependencies": {
|
|
"strapi": "3.2.5",
|
|
"strapi-admin": "3.2.5",
|
|
"strapi-connector-bookshelf": "3.2.5",
|
|
"strapi-plugin-content-manager": "3.2.5",
|
|
"strapi-plugin-content-type-builder": "3.2.5",
|
|
"strapi-plugin-email": "3.2.5",
|
|
"strapi-plugin-graphql": "3.2.5",
|
|
"strapi-plugin-upload": "3.2.5",
|
|
"strapi-plugin-users-permissions": "3.2.5",
|
|
"strapi-utils": "3.2.5"
|
|
//...
|
|
}
|
|
}
|
|
```
|
|
|
|
:::
|
|
|
|
::::
|
|
|
|
After editing the file run either `yarn install` or `npm install` to install the specified version.
|
|
|
|
::: tip
|
|
If the operation doesn't work, you should probably remove your `yarn.lock` or `package-lock.json`. If it still does not work, try again after also removing the folder `node_modules`.
|
|
:::
|
|
|
|
## Rebuild your administration panel
|
|
|
|
New releases can introduce changes to the administration panel that require a rebuild.
|
|
Rebuild the admin panel with one of the following commands:
|
|
|
|
```bash
|
|
yarn build --clean
|
|
# or
|
|
npm run build -- --clean
|
|
```
|
|
|
|
## Extensions
|
|
|
|
If you are using [extensions](../concepts/customization.md) to create custom code or modify existing code, you will need to update your code and compare your version to the new changes on the repository. Not updating your extensions can **break your app** in unexpected ways we cannot predict.
|
|
|
|
## Migration guides
|
|
|
|
Sometimes Strapi introduces **breaking changes** that need more than just the previous steps.
|
|
That is the reason for the [Migration guides](../migration-guide/README.md) page.
|
|
Just make sure when you update your version that a migration guide exists or not.
|
|
|
|
## Start your application
|
|
|
|
If you have followed the information above, you can start your application with:
|
|
|
|
```bash
|
|
yarn develop
|
|
# or
|
|
npm run develop
|
|
```
|
|
|
|
🎉 Congrats, your application has been migrated!
|