From dd54984ee20d698b450b1ac35a140e8491a496b4 Mon Sep 17 00:00:00 2001 From: Sofie Toft Date: Wed, 20 Aug 2025 13:36:12 +0200 Subject: [PATCH 01/10] Moved Unattended section into new article --- .../setup/upgrading/upgrade-details.md | 58 +----------------- .../setup/upgrading/upgrade-unattended.md | 59 +++++++++++++++++++ 2 files changed, 60 insertions(+), 57 deletions(-) create mode 100644 16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md diff --git a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md index 7a7e44fb4de..8229b486328 100644 --- a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md +++ b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md @@ -8,11 +8,10 @@ In this article, you will find everything you need to upgrade your Umbraco CMS p If you are new to upgrades, be sure to read the [introduction to upgrades in Umbraco first](./upgrade-introduction.md). -You will find instructions on how to upgrade to a new minor or major version as well as how to run upgrades unattended. +You will find instructions on how to upgrade to a new minor or major version. * [Upgrade to a new Major](./#upgrade-to-a-new-major) * [Upgrade to a new Minor](./#upgrade-to-a-new-minor) -* [Run an unattended upgrade](./#run-an-unattended-upgrade) * [Legacy Umbraco](./#legacy-umbraco) ## Upgrade to a new Major @@ -134,60 +133,6 @@ When the command completes, open the `.csproj` file to make sure the package ref ``` {% endcode %} -## Run an unattended upgrade - -When upgrading your Umbraco project, it is possible to enable the upgrade to run unattended. This means that you will not need to run through the installation wizard when upgrading. - -Below you will find the steps you need to take in order to upgrade your project unattended. - -{% hint style="info" %} -Are you running a load-balanced setup with multiple servers and environments? - -Check out the section about [Unattended upgrades in a load-balanced setup](./#unattended-upgrades-in-a-load-balanced-setup). -{% endhint %} - -### Enable the unattended upgrade feature - -1. Add the `Umbraco:Cms:Unattended:UpgradeUnattended` configuration key. -2. Set the value of the key to `true`. - -{% code title="appsettings.json" %} -```json -{ - "Umbraco": { - "CMS": { - "Unattended": { - "UpgradeUnattended": true - } - } - } -} -``` -{% endcode %} - -### Run the upgrade - -With the correct configuration applied, the project will be upgraded on the next boot. - -#### Boot order - -The Runtime level uses `Run` instead of `Upgrade` to allow the website to continue to boot up directly after the migration is run. This happens instead of initiating the otherwise required restart. - -{% hint style="info" %} -The upgrade is run after Composers but before Components, and the `UmbracoApplicationStartingNotification`. This is because the migration requires services that are registered in Composers, and Components require that Umbraco and the database are ready. -{% endhint %} - -### Unattended upgrades in a load-balanced setup - -Follow the steps outlined below to use unattended upgrades in a load-balanced setup. - -1. [Upgrade Umbraco via NuGet](./#upgrade-to-a-new-major). -2. Deploy to all environments. -3. Set the `Umbraco:CMS:Unattended:UpgradeUnattended` configuration key to `true` for **the Main server only**. -4. Boot the Main server, and the upgrade will run automatically. -5. Wait for the upgrade to complete. -6. Boot the Read-Only servers and ensure they do not show the “upgrade required” screen. - ## Legacy Umbraco The steps outlined in this article apply to Umbraco version 10 and later versions. @@ -201,4 +146,3 @@ Are you upgrading to a minor version for Umbraco 6, 7, or 8? You can find the ap {% content-ref url="version-specific/minor-upgrades-for-umbraco-7.md" %} [minor-upgrades-for-umbraco-7.md](version-specific/minor-upgrades-for-umbraco-7.md) {% endcontent-ref %} - diff --git a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md new file mode 100644 index 00000000000..fef06aada44 --- /dev/null +++ b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md @@ -0,0 +1,59 @@ +--- +description: Learn how to enable unattended upgrades, allowing your project to upgrade without your interference. +--- + +# Upgrade Unattended + +When upgrading your Umbraco project, it is possible to enable the upgrade to run unattended. This means that you will not need to run through the installation wizard when upgrading. + +Below you will find the steps you need to take in order to upgrade your project unattended. + +{% hint style="info" %} +Are you running a load-balanced setup with multiple servers and environments? + +Check out the section about [Unattended upgrades in a load-balanced setup](./#unattended-upgrades-in-a-load-balanced-setup). +{% endhint %} + +## Enable the unattended upgrade feature + +1. Add the `Umbraco:Cms:Unattended:UpgradeUnattended` configuration key. +2. Set the value of the key to `true`. + +{% code title="appsettings.json" %} + +```json +{ + "Umbraco": { + "CMS": { + "Unattended": { + "UpgradeUnattended": true + } + } + } +} +``` + +{% endcode %} + +## Run the upgrade + +With the correct configuration applied, the project will be upgraded on the next boot. + +### Boot order + +The Runtime level uses `Run` instead of `Upgrade` to allow the website to continue to boot up directly after the migration is run. This happens instead of initiating the otherwise required restart. + +{% hint style="info" %} +The upgrade is run after Composers but before Components, and the `UmbracoApplicationStartingNotification`. This is because the migration requires services that are registered in Composers, and Components require that Umbraco and the database are ready. +{% endhint %} + +## Unattended upgrades in a load-balanced setup + +Follow the steps outlined below to use unattended upgrades in a load-balanced setup. + +1. [Upgrade Umbraco via NuGet](./#upgrade-to-a-new-major). +2. Deploy to all environments. +3. Set the `Umbraco:CMS:Unattended:UpgradeUnattended` configuration key to `true` for **the Main server only**. +4. Boot the Main server, and the upgrade will run automatically. +5. Wait for the upgrade to complete. +6. Boot the Read-Only servers and ensure they do not show the “upgrade required” screen. From 6fc9dc9a50a49eccb742e78efa5854d461a1f6b0 Mon Sep 17 00:00:00 2001 From: Sofie Toft Date: Wed, 20 Aug 2025 13:40:54 +0200 Subject: [PATCH 02/10] Add links from landing page to sub articles --- 16/umbraco-cms/fundamentals/setup/upgrading/README.md | 10 +++++++--- 1 file changed, 7 insertions(+), 3 deletions(-) diff --git a/16/umbraco-cms/fundamentals/setup/upgrading/README.md b/16/umbraco-cms/fundamentals/setup/upgrading/README.md index 7e8176f4e69..65d761c3af5 100644 --- a/16/umbraco-cms/fundamentals/setup/upgrading/README.md +++ b/16/umbraco-cms/fundamentals/setup/upgrading/README.md @@ -1,11 +1,15 @@ --- -description: This is the guide for upgrading existing Umbraco installations. +description: Choose the guide fitting your upgrade situation and learn more about the recommended approach. --- # Upgrade your project In this section, you will find everything you need to upgrade your Umbraco CMS project. -If you are new to upgrades, see our introduction to [upgrades in Umbraco](./upgrade-introduction.md). This will give you an understanding of what goes on and the different topics you need to consider. +Before upgrading, it is recommended to **read the introduction to [upgrades in Umbraco](./upgrade-introduction.md)**. This will give you an understanding of what goes on and the different topics you need to consider. -Then we have step-by-step [upgrade instructions](./upgrade-details.md) for how to update your project to a newer version. \ No newline at end of file +## Upgrade Guides + +* [Upgrade details: Minor and Major upgrades](upgrade-details.md) +* [Upgrade Unattended](upgrade-unattended.md) +* [Version Specific upgrade notes](version-specific/README.md) From d08718d54aafed7507cec926c6a63dcbbdbe3d9c Mon Sep 17 00:00:00 2001 From: sofietoft Date: Wed, 20 Aug 2025 13:44:27 +0200 Subject: [PATCH 03/10] Update README.md --- 16/umbraco-cms/fundamentals/setup/upgrading/README.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/16/umbraco-cms/fundamentals/setup/upgrading/README.md b/16/umbraco-cms/fundamentals/setup/upgrading/README.md index 65d761c3af5..dd0e04cdc32 100644 --- a/16/umbraco-cms/fundamentals/setup/upgrading/README.md +++ b/16/umbraco-cms/fundamentals/setup/upgrading/README.md @@ -1,12 +1,12 @@ --- -description: Choose the guide fitting your upgrade situation and learn more about the recommended approach. +description: Select the guide that fits your upgrade situation and learn more about the recommended approach. --- # Upgrade your project In this section, you will find everything you need to upgrade your Umbraco CMS project. -Before upgrading, it is recommended to **read the introduction to [upgrades in Umbraco](./upgrade-introduction.md)**. This will give you an understanding of what goes on and the different topics you need to consider. +Before upgrading, it is recommended to **read the introduction to [upgrades in Umbraco](./upgrade-introduction.md)**. This provides an understanding of what happens and the different topics you need to consider. ## Upgrade Guides From 78053d966c443558393e6a0f52a2b11ceffe0abf Mon Sep 17 00:00:00 2001 From: sofietoft Date: Wed, 20 Aug 2025 13:45:50 +0200 Subject: [PATCH 04/10] Update upgrade-unattended.md --- .../fundamentals/setup/upgrading/upgrade-unattended.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md index fef06aada44..b6a37d1a71f 100644 --- a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md +++ b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md @@ -4,14 +4,14 @@ description: Learn how to enable unattended upgrades, allowing your project to u # Upgrade Unattended -When upgrading your Umbraco project, it is possible to enable the upgrade to run unattended. This means that you will not need to run through the installation wizard when upgrading. - -Below you will find the steps you need to take in order to upgrade your project unattended. +When upgrading your Umbraco project, you can enable the upgrade to run unattended. This means that you will not need to run through the installation wizard when upgrading. {% hint style="info" %} + Are you running a load-balanced setup with multiple servers and environments? Check out the section about [Unattended upgrades in a load-balanced setup](./#unattended-upgrades-in-a-load-balanced-setup). + {% endhint %} ## Enable the unattended upgrade feature From 2074847170f3696e92d314a3214d814a69c14950 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Wed, 20 Aug 2025 15:15:31 +0200 Subject: [PATCH 05/10] Update README.md --- 16/umbraco-cms/fundamentals/setup/upgrading/README.md | 6 +++--- 1 file changed, 3 insertions(+), 3 deletions(-) diff --git a/16/umbraco-cms/fundamentals/setup/upgrading/README.md b/16/umbraco-cms/fundamentals/setup/upgrading/README.md index dd0e04cdc32..7a3dd19959e 100644 --- a/16/umbraco-cms/fundamentals/setup/upgrading/README.md +++ b/16/umbraco-cms/fundamentals/setup/upgrading/README.md @@ -1,12 +1,12 @@ --- -description: Select the guide that fits your upgrade situation and learn more about the recommended approach. +description: Choose the guide fitting your upgrade situation and learn more about the recommended approach. --- # Upgrade your project -In this section, you will find everything you need to upgrade your Umbraco CMS project. +In this section, you will find resources to upgrade your Umbraco CMS project. -Before upgrading, it is recommended to **read the introduction to [upgrades in Umbraco](./upgrade-introduction.md)**. This provides an understanding of what happens and the different topics you need to consider. +Before upgrading, it is recommended to **read the [upgrade introduction](./upgrade-introduction.md) article**. This will give you an understanding of what goes on and the different topics you need to consider. ## Upgrade Guides From e01579d95bcb191a1e4128653d043298c56461e6 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Wed, 20 Aug 2025 15:15:52 +0200 Subject: [PATCH 06/10] Update upgrade-details.md --- .../fundamentals/setup/upgrading/upgrade-details.md | 12 +++++------- 1 file changed, 5 insertions(+), 7 deletions(-) diff --git a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md index 8229b486328..95b760fbc51 100644 --- a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md +++ b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md @@ -2,17 +2,15 @@ description: Describes how to upgrading existing installations to new versions. --- -# Upgrade Instructions +# Upgrade Details In this article, you will find everything you need to upgrade your Umbraco CMS project. -If you are new to upgrades, be sure to read the [introduction to upgrades in Umbraco first](./upgrade-introduction.md). +If you are new to upgrades, be sure to read the [upgrade introduction article](./upgrade-introduction.md) first. -You will find instructions on how to upgrade to a new minor or major version. - -* [Upgrade to a new Major](./#upgrade-to-a-new-major) -* [Upgrade to a new Minor](./#upgrade-to-a-new-minor) -* [Legacy Umbraco](./#legacy-umbraco) +* [Upgrade to a new Major](#upgrade-to-a-new-major) +* [Upgrade to a new Minor](#upgrade-to-a-new-minor) +* [Legacy Umbraco](#legacy-umbraco) ## Upgrade to a new Major From 7356df567c703a42b718928f2bec96ae5e4c1628 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Wed, 20 Aug 2025 15:17:24 +0200 Subject: [PATCH 07/10] Update SUMMARY.md --- 16/umbraco-cms/SUMMARY.md | 1 + 1 file changed, 1 insertion(+) diff --git a/16/umbraco-cms/SUMMARY.md b/16/umbraco-cms/SUMMARY.md index 74944bf5458..059cd113c97 100644 --- a/16/umbraco-cms/SUMMARY.md +++ b/16/umbraco-cms/SUMMARY.md @@ -33,6 +33,7 @@ * [Minor upgrades for Umbraco 8](fundamentals/setup/upgrading/version-specific/minor-upgrades-for-umbraco-8.md) * [Upgrade to Umbraco 7](fundamentals/setup/upgrading/version-specific/upgrade-to-umbraco-7.md) * [Minor upgrades for Umbraco 7](fundamentals/setup/upgrading/version-specific/minor-upgrades-for-umbraco-7.md) + * [Upgrade Unattended](fundamentals/setup/upgrading/upgrade-unattended.md) * [Server setup](fundamentals/setup/server-setup/README.md) * [Running Umbraco On Azure Web Apps](fundamentals/setup/server-setup/azure-web-apps.md) * [Hosting Umbraco in IIS](fundamentals/setup/server-setup/iis.md) From f0e49361c54b1c2a19521744378d2b4897989bfa Mon Sep 17 00:00:00 2001 From: sofietoft Date: Thu, 21 Aug 2025 09:42:39 +0200 Subject: [PATCH 08/10] Update SUMMARY.md --- 16/umbraco-cms/SUMMARY.md | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/16/umbraco-cms/SUMMARY.md b/16/umbraco-cms/SUMMARY.md index 059cd113c97..fd7af5e9dc7 100644 --- a/16/umbraco-cms/SUMMARY.md +++ b/16/umbraco-cms/SUMMARY.md @@ -25,7 +25,7 @@ * [Unattended Installs](fundamentals/setup/install/unattended-install.md) * [Upgrade your project](fundamentals/setup/upgrading/README.md) * [Upgrades in Umbraco](fundamentals/setup/upgrading/upgrade-introduction.md) - * [Upgrade Instructions](fundamentals/setup/upgrading/upgrade-details.md) + * [Upgrade Details](fundamentals/setup/upgrading/upgrade-details.md) * [Version Specific Upgrades](fundamentals/setup/upgrading/version-specific/README.md) * [Upgrade from Umbraco 8 to the latest version](fundamentals/setup/upgrading/version-specific/upgrade-from-8-to-latest.md) * [Migrate content to Umbraco 15](fundamentals/setup/upgrading/version-specific/migrate-content-to-umbraco-15.md) From 71217d38a200c0551ec65453fd525b8edd37be11 Mon Sep 17 00:00:00 2001 From: sofietoft Date: Thu, 21 Aug 2025 09:43:07 +0200 Subject: [PATCH 09/10] Apply suggestions from code review Co-authored-by: Esha Noronha <82437098+eshanrnh@users.noreply.github.com> --- .../fundamentals/setup/upgrading/upgrade-details.md | 2 +- .../fundamentals/setup/upgrading/upgrade-unattended.md | 4 ++-- 2 files changed, 3 insertions(+), 3 deletions(-) diff --git a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md index 95b760fbc51..f6fbb368de3 100644 --- a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md +++ b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md @@ -1,5 +1,5 @@ --- -description: Describes how to upgrading existing installations to new versions. +description: Describes how to upgrade existing installations to new versions. --- # Upgrade Details diff --git a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md index b6a37d1a71f..a67b9428f3d 100644 --- a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md +++ b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md @@ -53,7 +53,7 @@ Follow the steps outlined below to use unattended upgrades in a load-balanced se 1. [Upgrade Umbraco via NuGet](./#upgrade-to-a-new-major). 2. Deploy to all environments. -3. Set the `Umbraco:CMS:Unattended:UpgradeUnattended` configuration key to `true` for **the Main server only**. +3. Set the `Umbraco:CMS:Unattended:UpgradeUnattended` configuration key to `true` for the **Main server** only. 4. Boot the Main server, and the upgrade will run automatically. 5. Wait for the upgrade to complete. -6. Boot the Read-Only servers and ensure they do not show the “upgrade required” screen. +6. Boot the **Read-Only** servers and ensure they do not show the “Upgrade Required” screen. From 1c6060a86dd63910aed1ed826c02a79e5b9bcb6e Mon Sep 17 00:00:00 2001 From: sofietoft Date: Thu, 21 Aug 2025 09:45:04 +0200 Subject: [PATCH 10/10] Update links --- .../fundamentals/setup/upgrading/upgrade-unattended.md | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md index a67b9428f3d..dc5e184078e 100644 --- a/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md +++ b/16/umbraco-cms/fundamentals/setup/upgrading/upgrade-unattended.md @@ -10,7 +10,7 @@ When upgrading your Umbraco project, you can enable the upgrade to run unattende Are you running a load-balanced setup with multiple servers and environments? -Check out the section about [Unattended upgrades in a load-balanced setup](./#unattended-upgrades-in-a-load-balanced-setup). +Check out the section about [Unattended upgrades in a load-balanced setup](#unattended-upgrades-in-a-load-balanced-setup). {% endhint %} @@ -51,7 +51,7 @@ The upgrade is run after Composers but before Components, and the `UmbracoApplic Follow the steps outlined below to use unattended upgrades in a load-balanced setup. -1. [Upgrade Umbraco via NuGet](./#upgrade-to-a-new-major). +1. [Upgrade Umbraco via NuGet](upgrade-details.md#upgrade-to-a-new-major). 2. Deploy to all environments. 3. Set the `Umbraco:CMS:Unattended:UpgradeUnattended` configuration key to `true` for the **Main server** only. 4. Boot the Main server, and the upgrade will run automatically.