Manual upgrade of Umbraco Deploy

Learn how to manually upgrade the Umbraco Deploy version used on your Umbraco Cloud project.

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 very first step is to clone down your Cloud Development environment to your local machine.

Make sure you can run your Cloud project locally and restore content and media. It's important that you check that everything works once the upgrade has been applied and for 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,

NuGet installs the latest version of the package when you use the dotnet add package command unless you specify a package version:

dotnet add package Umbraco.Deploy.Cloud --version <VERSION> dotnet add package Umbraco.Deploy.Forms --version <VERSION>

After you have added a package reference to your project by executing the commands above in the directory that contains your project file, run dotnet restore to install the packages.

You can also update the Umbraco Deploy through the NuGet Package Manager in Visual studio:

NuGet Package Manager

When the command completes, open the .csproj file to make sure the package reference was updated:

<ItemGroup>
  <PackageReference Include="Umbraco.Deploy.Cloud" Version="9.0.1" />
  <PackageReference Include="Umbraco.Deploy.Forms" Version="9.0.1" />
</ItemGroup>

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: https://azure.microsoft.com/en-us/products/storage/storage-explorer and install it.
2. Click the "Plug" Button (Open Connect Dialog):

1. Choose "Blob container or directory":

1. Choose "Anonymously" when prompted on how you will connect to the blob container.

1. Enter https://umbraconightlies.blob.core.windows.net/umbraco-deploy-release in the "Blob container or directory URL":\

1. You will then get a list of files available to download:

1. Download the latest version of Umbraco Deploy. Check Product Dependencies to be sure you download the correct version of Deploy.
2. Download the to your computer

3. Unzip the file on your computer

4. 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

5. Run the project locally - make sure it runs without any errors

6. Commit and deploy the changes to the Cloud environment

7. 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