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
- Purpose: add the EOL support-policy changes to the release archive docs branch.
- Before: the version archive grouped releases by stable, previous, and legacy without clearly explaining superseded builds or EOL support boundaries.
- Problem: users could confuse archived or older patch builds with currently supported update targets.
- Now: the docs define supported minor series, superseded patch builds, and EOL releases across the archive, licensing FAQ, and release-types guide.
- Implementation: simplify the VersionsTable status filters, mark current and previous series support status dynamically, and update the 7.3.0 release notes to stable-release wording.
Use this archive to find release notes and download links for Unraid OS versions. To update an existing server, use the built-in updater; see the [standard update process](./updating-unraid/index.mdx#standard-update-process) for steps. To create a new boot device, use the [Unraid USB Creator](https://unraid.net/download).
11
11
12
-
If you are deciding which release to install, start with [Unraid OS release types](./updating-unraid/release-types.mdx).
12
+
The archive groups releases by support status. Only the latest patch or pre-release build in a supported minor series receives updates as appropriate; older builds in the same series are superseded. Releases marked **EOL** are not supported and no longer include updates.
13
+
14
+
If you are deciding which release to install, start with [Unraid OS release types](./updating-unraid/release-types.mdx). For license eligibility details, see the [Licensing FAQ](./troubleshooting/licensing-faq.mdx#no-extension).
Copy file name to clipboardExpand all lines: docs/unraid-os/troubleshooting/licensing-faq.mdx
+23-15Lines changed: 23 additions & 15 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -47,7 +47,7 @@ For bulk OEM/reseller pricing (10 licenses or more), [contact Unraid](https://un
47
47
48
48
### How do I upgrade my Unraid license? {/* #upgrade-license */}
49
49
50
-
You can upgrade your license at any time from within the %%WebGUI|web-gui%% (***Tools → Registration***) or [via the account portal](https://account.unraid.net/keys) (by clicking **••• More** and selecting **Upgrade Key**).
50
+
You can upgrade your license at any time from within the %%WebGUI|web-gui%% (**_Tools → Registration_**) or [via the account portal](https://account.unraid.net/keys) (by clicking **••• More** and selecting **Upgrade Key**).
<sup>1</sup> Attached storage devices include all devices present before array start, except one eMMC device and one USB device.\
70
-
<sup>2</sup> "Unlimited" means you are not limited by the license, but by hardware and OS constraints. Additional storage devices can be used for %%VMs|vm%%, unassigned devices, or other Unraid features.\*
69
+
<sup>1</sup> Attached storage devices include all devices present before array
70
+
start, except one eMMC device and one USB device.\
71
+
<sup>2</sup> "Unlimited" means you are not limited by the license, but by
72
+
hardware and OS constraints. Additional storage devices can be used for
73
+
%%VMs|vm%%, unassigned devices, or other Unraid features.\*
71
74
72
75
### How do I manually install my license keyfile to my boot device? {/* #manual-keyfile-install */}
73
76
74
77
#### Install via WebGUI download
75
78
76
79
1. Navigate to [account.unraid.net/keys](https://account.unraid.net/keys), select **View options** next to your key, then click **Copy Key URL**.
77
-
2. Navigate to your server's ***Tools → Registration***.
80
+
2. Navigate to your server's **_Tools → Registration_**.
78
81
3. Scroll to the bottom of the Registration page, to the **Install Key** section.
79
82
4. Paste the URL into the **Key file URL** field, and click **Install**.
80
83
@@ -88,16 +91,16 @@ You can upgrade your license at any time from within the %%WebGUI|web-gui%% (***
88
91
89
92
This does not apply if you have configured internal boot.
90
93
91
-
1. Ensure you have a recent backup of your USB drive. Use [Unraid Connect](../../unraid-connect/overview-and-setup.mdx) (recommended) or the local backup option at ***Main → Boot Device → Boot Device Backup*** (on releases before 7.3.0, use ***Main → Flash device → FLASH BACKUP***).
94
+
1. Ensure you have a recent backup of your USB drive. Use [Unraid Connect](../../unraid-connect/overview-and-setup.mdx) (recommended) or the local backup option at **_Main → Boot Device → Boot Device Backup_** (on releases before 7.3.0, use **_Main → Flash device → FLASH BACKUP_**).
92
95
2. Shut down your Unraid server and remove the USB boot device.
93
96
3. Insert the USB drive into another computer.
94
97
4. Open the USB drive and copy your `.key` file into the `/config` folder.
95
-
*Make sure this is the only `.key` file present - delete any others.*
98
+
_Make sure this is the only `.key` file present - delete any others._
96
99
5. Safely eject the USB drive, reinstall it in your server, and reboot.
97
100
98
101
### How can I determine my registration type? {/* #registration-type */}
99
102
100
-
Navigate to ***Tools → Registration*** in the %%WebGUI|web-gui%%. Here, you can find your current license type and registration details.
103
+
Navigate to **_Tools → Registration_** in the %%WebGUI|web-gui%%. Here, you can find your current license type and registration details.
101
104
102
105
For internal boot questions, see the [Internal Boot FAQ (7.3+)](../getting-started/set-up-unraid/internal-boot-faq.mdx).
103
106
For TPM-based licensing questions, see the [TPM Licensing FAQ (7.3+)](tpm-licensing-faq.mdx).
@@ -120,16 +123,18 @@ You continue to own your license even if you stop paying for updates.
120
123
121
124
- You keep your license and can use your current version of Unraid OS indefinitely.
122
125
- You won't receive new feature updates or major version upgrades.
123
-
- You remain eligible for patch releases and security updates within the same minor version (e.g., 7.1.x if your license lapsed at 7.1.0).
124
-
- Once a new minor version is released (e.g., 7.2.0), only security patches are provided for the previous minor version.
125
-
- When a version reaches end-of-life (EOL), no further updates are provided.
126
-
- You can pay the extension fee at any time to regain access to the latest updates.
126
+
- You remain eligible for updates to the latest patch release within your minor version (e.g., if your license lapsed at 7.1.0, you can install any 7.1.x release while 7.1 is a supported minor version).
127
+
- Lime Technology supports the two most recent publicly released minor versions at any given time. A "public" release includes Stable, Release Candidate (RC), and Beta builds.
128
+
- When a newer minor or major version becomes public — including a public Beta or RC — the oldest currently supported minor version reaches end-of-life (EOL) and no further updates are issued for it.
129
+
- Once your minor version is EOL, you can continue running it indefinitely, but you will no longer receive security patches or bug fixes. To receive updates again, extend your license at [unraid.net/pricing](https://unraid.net/pricing) and update to a supported version.
130
+
- You can see the current support status of each release in the [Version Archive](https://docs.unraid.net/unraid-os/download_list/).
127
131
128
132
### What happens with pre-releases (Beta/RC versions)? {/* #pre-release-policy */}
129
133
130
134
- Pre-release (Beta and Release Candidate) versions are for testing and may contain bugs.
131
135
- Only install pre-releases on non-production systems.
132
-
- Support for pre-releases ends when the stable version is released.
136
+
- A public pre-release counts as the current public minor series when determining which minor series are supported.
137
+
- Support for a specific pre-release build ends when it is superseded by a newer pre-release or the corresponding stable release.
133
138
- Your license must be eligible for OS updates on the stable release date to receive the stable version.
134
139
- If your license expires before the stable release, you must extend your license to upgrade or roll back to a supported stable version.
135
140
- Your license remains valid after expiration; you only need an active license for new updates.
@@ -150,8 +155,11 @@ Here are the current limits:
150
155
151
156
</div>
152
157
153
-
<sup>1</sup> Attached storage devices include all devices present before %%array|array%% start, except one eMMC device and one USB device.\
154
-
<sup>2</sup> "Unlimited" means you are not limited by the license, but by hardware and OS constraints. Additional storage devices can be used for %%VMs|vm%%, unassigned devices, or other Unraid features.\*
158
+
<sup>1</sup> Attached storage devices include all devices present before
159
+
%%array|array%% start, except one eMMC device and one USB device.\
160
+
<sup>2</sup> "Unlimited" means you are not limited by the license, but by
161
+
hardware and OS constraints. Additional storage devices can be used for
162
+
%%VMs|vm%%, unassigned devices, or other Unraid features.\*
155
163
156
164
---
157
165
@@ -166,7 +174,7 @@ To transfer your license:
166
174
1. Prepare new, high-quality [boot media](../getting-started/set-up-unraid/create-your-bootable-media.mdx) (for example a USB flash drive).
167
175
2. Install Unraid OS on the new device using the USB Flash Creator or a manual method.
168
176
3. Boot your server with the new boot device.
169
-
4. Go to ***Tools → Registration*** in the %%WebGUI|web-gui%%.
177
+
4. Go to **_Tools → Registration_** in the %%WebGUI|web-gui%%.
170
178
5. Click **Replace Key** and follow the prompts to transfer your license to the new device.
171
179
172
180
The first transfer can be done at any time, while subsequent transfers are allowed once every 12 months using the automated system. If you need to transfer your license again before the 12-month period, contact Unraid support with your old and new USB %%GUID|guid%%s for manual assistance.
Copy file name to clipboardExpand all lines: docs/unraid-os/updating-unraid/release-types.mdx
+25-9Lines changed: 25 additions & 9 deletions
Display the source diff
Display the rich diff
Original file line number
Diff line number
Diff line change
@@ -11,12 +11,27 @@ For most servers, use the latest **Stable** release. Use **Beta** or **Release C
11
11
12
12
## Release types at a glance
13
13
14
-
| Release type | Example version | Best for | What to expect |
15
-
| --- | --- | --- | --- |
16
-
|**Stable**|`7.2.0`, then `7.2.1`, `7.2.2`, and later patches | Production servers | General availability release recommended for normal use. A stable series often begins with a `.0` minor release, then receives patch releases with fixes and compatibility updates. |
17
-
|**Release Candidate (RC)**|`7.3.0-rc.1`| Final validation on test systems | A pre-release that is expected to be close to stable, but may still include unresolved issues or last-minute changes. |
18
-
|**Beta**|`7.3.0-beta.2`| Early testing and feedback | A pre-release used to test new features, platform changes, fixes, and upgrade paths before the release is ready for stable use. |
19
-
|**Withdrawn pre-release**| Varies | Moving off an unavailable test build | A beta or RC that is no longer enabled for regular use. Update to the latest stable release unless the release notes say otherwise. |
14
+
| Release type | Example version | Best for | What to expect |
|**Stable**|`7.2.0`, then `7.2.1`, `7.2.2`, and later patches | Production servers | General availability release recommended for normal use. A stable series often begins with a `.0` minor release, then receives patch releases with fixes and compatibility updates. |
17
+
|**Release Candidate (RC)**|`7.3.0-rc.1`| Final validation on test systems | A pre-release that is expected to be close to stable, but may still include unresolved issues or last-minute changes. |
18
+
|**Beta**|`7.3.0-beta.2`| Early testing and feedback | A pre-release used to test new features, platform changes, fixes, and upgrade paths before the release is ready for stable use. |
19
+
|**Withdrawn pre-release**| Varies | Moving off an unavailable test build | A beta or RC that is no longer enabled for regular use. Update to the latest stable release unless the release notes say otherwise. |
20
+
21
+
## Supported minor series and EOL
22
+
23
+
Unraid supports two public minor series at a time:
24
+
25
+
- The **current public minor series**, such as `7.3.x` once any `7.3` beta, RC, or stable release is public.
26
+
- The **previous public minor series**, such as `7.2.x` while `7.3.x` is the current public series.
27
+
28
+
A public beta or RC counts as a public minor series for support-policy purposes. This does not mean beta or RC releases are recommended for production use; it only means the support window moves forward when the next minor series becomes public.
29
+
30
+
Within a supported minor series, use the latest available patch or pre-release build for that series. Older patch builds in the same series are superseded and remain available only for archive, rollback, and release-note reference.
31
+
32
+
Older minor series are **End of Life (EOL)**. EOL releases are not supported and no longer include bug fixes or security updates.
33
+
34
+
To check the current status of a release, see the [Version Archive](../download_list.mdx).
20
35
21
36
## Stable releases
22
37
@@ -61,7 +76,7 @@ RC releases are useful when:
61
76
62
77
## Release branches and the Update OS tool
63
78
64
-
In the WebGUI, open ***Tools -> Update OS*** or use **Check for Update** from the top-right menu.
79
+
In the WebGUI, open **_Tools -> Update OS_** or use **Check for Update** from the top-right menu.
65
80
66
81
The Update OS tool shows updates for the release branch your server is already using. To change release branches, open the top-right account menu and choose **Manage Unraid.net Account** to manage the server in the [Unraid account app](../../unraid-account/server-management.mdx). You cannot switch release branches directly from inside the OS.
67
82
@@ -77,7 +92,8 @@ Your license remains valid even if your update eligibility expires. Update eligi
77
92
For pre-releases:
78
93
79
94
- Beta and RC versions are for testing and may contain bugs.
80
-
- Support for a pre-release ends when the corresponding stable version is released.
95
+
- Public beta and RC versions count when identifying the current public minor series.
96
+
- Support for a specific pre-release build ends when it is superseded by a newer pre-release or the corresponding stable release.
81
97
- Your license must be eligible for OS updates on the stable release date to receive that stable version.
82
98
- If your update eligibility expires before the stable release, you must extend your license to upgrade to that stable version or roll back to a supported stable version that your license allows.
83
99
@@ -100,7 +116,7 @@ Good feedback helps turn beta and RC builds into better stable releases and help
100
116
101
117
- The exact Unraid OS version.
102
118
- Whether the issue started after updating.
103
-
- Diagnostics from ***Tools -> Diagnostics***.
119
+
- Diagnostics from **_Tools -> Diagnostics_**.
104
120
- Steps to reproduce the issue.
105
121
- Any relevant plugin, Docker, VM, network, or storage configuration details.
0 commit comments