Upgrade a git-based installation

This topic discusses how a contributing developer can update Adobe Commerce or Magento Open Source without reinstalling it. If you are not a contributing developer, see Perform an upgrade.

To upgrade if you are a contributing developer:

1. Log in to your server.

2. Switch to the file system owner.

3. Change to the directory where you cloned the application. For example,

   cd /var/www/magento2
   

4. Save any changes you made to the composer.json file because the next steps overwrite it.

5. Create a backup of your composer.json file.

   cp composer.json composer.json.old
   

6. Update your local repository to get the latest code:

   git pull origin develop
   

   NOTE

   If git pull origin develop fails, see troubleshooting.

7. Diff and merge your composer.json.old file with the composer.json file.

8. Resolve dependencies and write exact versions to the composer.lock file.

   composer update
   

9. Update the database:

   bin/magento setup:upgrade
   

10. Clean the cache:

    bin/magento cache:clean