You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
description: This is the guide for upgrading existing Umbraco installations.
2
+
description: Choose the guide fitting your upgrade situation and learn more about the recommended approach.
3
3
---
4
4
5
5
# Upgrade your project
6
6
7
-
In this section, you will find everything you need to upgrade your Umbraco CMS project.
7
+
In this section, you will find resources to upgrade your Umbraco CMS project.
8
8
9
-
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.
9
+
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.
10
10
11
-
Then we have step-by-step [upgrade instructions](./upgrade-details.md) for how to update your project to a newer version.
11
+
## Upgrade Guides
12
+
13
+
*[Upgrade details: Minor and Major upgrades](upgrade-details.md)
14
+
*[Upgrade Unattended](upgrade-unattended.md)
15
+
*[Version Specific upgrade notes](version-specific/README.md)
Copy file name to clipboardExpand all lines: 16/umbraco-cms/fundamentals/setup/upgrading/upgrade-details.md
+6-64Lines changed: 6 additions & 64 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -1,19 +1,16 @@
1
1
---
2
-
description: Describes how to upgrading existing installations to new versions.
2
+
description: Describes how to upgrade existing installations to new versions.
3
3
---
4
4
5
-
# Upgrade Instructions
5
+
# Upgrade Details
6
6
7
7
In this article, you will find everything you need to upgrade your Umbraco CMS project.
8
8
9
-
If you are new to upgrades, be sure to read the [introduction to upgrades in Umbraco first](./upgrade-introduction.md).
9
+
If you are new to upgrades, be sure to read the [upgrade introduction article](./upgrade-introduction.md) first.
10
10
11
-
You will find instructions on how to upgrade to a new minor or major version as well as how to run upgrades unattended.
12
-
13
-
*[Upgrade to a new Major](./#upgrade-to-a-new-major)
14
-
*[Upgrade to a new Minor](./#upgrade-to-a-new-minor)
15
-
*[Run an unattended upgrade](./#run-an-unattended-upgrade)
16
-
*[Legacy Umbraco](./#legacy-umbraco)
11
+
*[Upgrade to a new Major](#upgrade-to-a-new-major)
12
+
*[Upgrade to a new Minor](#upgrade-to-a-new-minor)
13
+
*[Legacy Umbraco](#legacy-umbraco)
17
14
18
15
## Upgrade to a new Major
19
16
@@ -134,60 +131,6 @@ When the command completes, open the `.csproj` file to make sure the package ref
134
131
```
135
132
{% endcode %}
136
133
137
-
## Run an unattended upgrade
138
-
139
-
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.
140
-
141
-
Below you will find the steps you need to take in order to upgrade your project unattended.
142
-
143
-
{% hint style="info" %}
144
-
Are you running a load-balanced setup with multiple servers and environments?
145
-
146
-
Check out the section about [Unattended upgrades in a load-balanced setup](./#unattended-upgrades-in-a-load-balanced-setup).
147
-
{% endhint %}
148
-
149
-
### Enable the unattended upgrade feature
150
-
151
-
1. Add the `Umbraco:Cms:Unattended:UpgradeUnattended` configuration key.
152
-
2. Set the value of the key to `true`.
153
-
154
-
{% code title="appsettings.json" %}
155
-
```json
156
-
{
157
-
"Umbraco": {
158
-
"CMS": {
159
-
"Unattended": {
160
-
"UpgradeUnattended": true
161
-
}
162
-
}
163
-
}
164
-
}
165
-
```
166
-
{% endcode %}
167
-
168
-
### Run the upgrade
169
-
170
-
With the correct configuration applied, the project will be upgraded on the next boot.
171
-
172
-
#### Boot order
173
-
174
-
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.
175
-
176
-
{% hint style="info" %}
177
-
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.
178
-
{% endhint %}
179
-
180
-
### Unattended upgrades in a load-balanced setup
181
-
182
-
Follow the steps outlined below to use unattended upgrades in a load-balanced setup.
183
-
184
-
1.[Upgrade Umbraco via NuGet](./#upgrade-to-a-new-major).
185
-
2. Deploy to all environments.
186
-
3. Set the `Umbraco:CMS:Unattended:UpgradeUnattended` configuration key to `true` for **the Main server only**.
187
-
4. Boot the Main server, and the upgrade will run automatically.
188
-
5. Wait for the upgrade to complete.
189
-
6. Boot the Read-Only servers and ensure they do not show the “upgrade required” screen.
190
-
191
134
## Legacy Umbraco
192
135
193
136
The steps outlined in this article apply to Umbraco version 10 and later versions.
@@ -201,4 +144,3 @@ Are you upgrading to a minor version for Umbraco 6, 7, or 8? You can find the ap
description: Learn how to enable unattended upgrades, allowing your project to upgrade without your interference.
3
+
---
4
+
5
+
# Upgrade Unattended
6
+
7
+
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.
8
+
9
+
{% hint style="info" %}
10
+
11
+
Are you running a load-balanced setup with multiple servers and environments?
12
+
13
+
Check out the section about [Unattended upgrades in a load-balanced setup](#unattended-upgrades-in-a-load-balanced-setup).
14
+
15
+
{% endhint %}
16
+
17
+
## Enable the unattended upgrade feature
18
+
19
+
1. Add the `Umbraco:Cms:Unattended:UpgradeUnattended` configuration key.
20
+
2. Set the value of the key to `true`.
21
+
22
+
{% code title="appsettings.json" %}
23
+
24
+
```json
25
+
{
26
+
"Umbraco": {
27
+
"CMS": {
28
+
"Unattended": {
29
+
"UpgradeUnattended": true
30
+
}
31
+
}
32
+
}
33
+
}
34
+
```
35
+
36
+
{% endcode %}
37
+
38
+
## Run the upgrade
39
+
40
+
With the correct configuration applied, the project will be upgraded on the next boot.
41
+
42
+
### Boot order
43
+
44
+
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.
45
+
46
+
{% hint style="info" %}
47
+
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.
48
+
{% endhint %}
49
+
50
+
## Unattended upgrades in a load-balanced setup
51
+
52
+
Follow the steps outlined below to use unattended upgrades in a load-balanced setup.
53
+
54
+
1.[Upgrade Umbraco via NuGet](upgrade-details.md#upgrade-to-a-new-major).
55
+
2. Deploy to all environments.
56
+
3. Set the `Umbraco:CMS:Unattended:UpgradeUnattended` configuration key to `true` for the **Main server** only.
57
+
4. Boot the Main server, and the upgrade will run automatically.
58
+
5. Wait for the upgrade to complete.
59
+
6. Boot the **Read-Only** servers and ensure they do not show the “Upgrade Required” screen.
0 commit comments