2020-05-25 18:11:45 +02:00
# Update Strapi version
2020-11-10 17:54:09 +01:00
With this guide you will know how to upgrade your application to the latest version of Strapi.
::: tip NOTE
When a new version of Strapi is available, you will be notified both in your terminal, and in the admin panel. < br >
Also note that you can check the **Settings > Application** section of the admin panel to have more information on:
- The versions of Strapi and Node you are currently using.
- If relevant, the versions we recommend you to upgrade to.
:::
::: warning CAUTION
Before you start, make sure your server is not running until the end of the guide!
:::
2020-05-25 18:11:45 +02:00
2020-10-28 15:46:15 +01:00
## Upgrade your dependencies
2020-05-25 18:11:45 +02:00
2020-10-28 15:46:15 +01:00
Start by upgrading all your Strapi packages in your `package.json` .< br >
For example upgrading from `3.2.4` to `3.2.5` :
2020-05-25 18:11:45 +02:00
:::: tabs
2020-10-28 15:46:15 +01:00
::: tab 3.2.4
2020-05-25 18:11:45 +02:00
```json
{
//...
"dependencies": {
2020-10-28 15:46:15 +01:00
"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"
//...
2020-05-25 18:11:45 +02:00
}
}
```
:::
2020-10-28 15:46:15 +01:00
::: tab 3.2.5
2020-05-25 18:11:45 +02:00
```json
{
//...
"dependencies": {
2020-10-28 15:46:15 +01:00
"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"
//...
2020-05-25 18:11:45 +02:00
}
}
```
:::
::::
2020-10-28 15:46:15 +01:00
After editing the file run either `yarn install` or `npm install` to install the specified version.
2020-05-25 18:11:45 +02:00
::: tip
2020-10-28 15:46:15 +01:00
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` .
2020-05-25 18:11:45 +02:00
:::
2020-10-28 15:46:15 +01:00
## Rebuild your administration panel
2020-05-25 18:11:45 +02:00
New releases can introduce changes to the administration panel that require a rebuild.
2020-10-28 15:46:15 +01:00
Rebuild the admin panel with one of the following commands:
2020-05-25 18:11:45 +02:00
```bash
2020-10-28 15:46:15 +01:00
yarn build --clean
# or
npm run build -- --clean
2020-05-25 18:11:45 +02:00
```
2020-10-28 15:46:15 +01:00
## Extensions
2020-10-27 15:39:38 +01:00
2020-10-28 15:46:15 +01:00
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.
2020-05-25 18:11:45 +02:00
2020-10-28 15:46:15 +01:00
## Migration guides
2020-10-27 15:39:38 +01:00
2020-10-28 15:46:15 +01:00
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.
2020-10-27 15:39:38 +01:00
2020-10-28 15:46:15 +01:00
## Start your application
If you have followed the information above, you can start your application with:
2020-10-27 15:39:38 +01:00
```bash
2020-10-28 15:46:15 +01:00
yarn develop
# or
npm run develop
2020-05-25 18:11:45 +02:00
```
2020-10-28 15:46:15 +01:00
🎉 Congrats, your application has been migrated!