# Manual upgrade of Umbraco Deploy Deploy on Cloud will either be automatically upgraded with patch releases or it can be done through the portal when new minors are available. In rare cases, Deploy might not be on the latest patch or minor and you will need to upgrade Deploy manually. This article will give you a step-by-step on how to manually upgrade the deployment engine used on your Umbraco Cloud project. ## Prepare for the upgrade When upgrading an Umbraco Cloud project manually, the first step is to [clone down your Cloud Development environment to your local machine](/umbraco-cloud/build-and-customize-your-solution/handle-deployments-and-environments/working-locally.md). Make sure you can run your Cloud project locally and restore content and media. It is important that you check that everything works correctly after the upgrade. To achieve this, you need to have a clone locally that resembles the Cloud environment as much as possible. ## Get the latest version of Umbraco To get the latest version of Umbraco Deploy you will need to upgrade the site using NuGet. The main package to install is `Umbraco.Deploy.Cloud`. This has dependencies on other components of Umbraco Deploy that will be imported automatically. If using Umbraco Forms in your installation, you should also update the `Umbraco.Deploy.Forms` package reference. 1. Run the `dotnet add package Umbraco.Deploy.Cloud` command in the directory that contains your project files. If you want a specific package version, run these commands: * `dotnet add package Umbraco.Deploy.Cloud --version ` * `dotnet add package Umbraco.Deploy.Forms --version ` 2. Run `dotnet restore` to install the packages. 3. Open your `.csproj` file to make sure the package reference is updated: ```xml ``` Alternatively, you can also update Umbraco Deploy via the **NuGet Package Manager** in Visual studio: ![NuGet Package Manager](/files/Nj2AgzEsJFDMeiyPS0uO) Make sure that everything works on the local clone and that you can **run the project without any errors**. ## Manually Upgrade Umbraco Deploy Legacy Version 7 and 8
If you are on Umbraco 7 or Umbraco 8, follow these steps to manually upgrade Umbraco Deploy to a later version of your project 1. Download **Storage Explorer** here: and install it. 2. Click the **"Plug"** Button (Open Connect Dialog):\ ![Click the "Plug" Button (Open Connect Dialog)](/files/DUWD0f7Qmyt9lWfXMZEQ) 3. Choose **"Blob container or directory"**:![](/files/Qo7PnATMm4XsSype42jD) 4. Choose **"Anonymously"** when prompted on how you will connect to the blob container.![](/files/nwKmw1e5KAquUYKgy7J7) 5. Enter `https://umbraconightlies.blob.core.windows.net/umbraco-deploy-release` in the **Blob container or directory URL.** 6. You will then get a list of files available to download: 7. Download the latest version of Umbraco Deploy. Check [Product Dependencies](https://docs.umbraco.com/umbraco-cloud/product-upgrades/product-dependencies) to be sure you download the correct version of Deploy. 8. Download the to your computer 9. Unzip the file on your computer 10. Copy/Paste the files from the unzipped folder to your local project folder You should not overwrite the following files: ``` Config/UmbracoDeploy.config Config/UmbracoDeploy.Settings.config ``` 11. Run the project locally - make sure it runs without any errors 12. Commit and deploy the changes to the Cloud environment 13. Again, make sure everything runs without errors before deploying to the next Cloud environment
## Push upgrade to Cloud When you've upgraded everything locally, and made sure that everything runs without any errors, you are ready to deploy the upgrade to Umbraco Cloud. * Stage and commit all changes in Git * Push the changes to the Cloud environment * When everything is pushed, head on over to the Umbraco Cloud Portal * Make sure everything runs without errors before deploying to the next Cloud environment --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.umbraco.com/umbraco-cloud/optimize-and-maintain-your-site/manage-product-upgrades/product-upgrades/manual-upgrades/manual-upgrade-deploy.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.