New & Improved Update OS Tool

04a check for update response modal

We are excited to announce a newly improved Update OS flow for Unraid OS! With this latest update, we have made significant improvements to make the Update OS process more user-friendly and efficient.

This is an entirely new experience from the old updater and was designed to streamline the process, better surface release information, and resolve some common issues.

Available today via the Unraid Connect plugin; go to the Plugins page on your server to update your plugin.

Coming soon for all users in an upcoming Unraid OS release.

How the New Update OS Works

When checking for an update the server's license information, flash information (vendor, model, GUID), and basic server details (like name, description, IP, version) are used to validate your license and help us provide a better customer experience.

You have a few options for checking for an update.

Option 1 – Open the dropdown in the top-right of the Unraid webgui, click Check for Update

02b open top right dropdown closeup

Screenshot from server with Unraid Connect installed, non-Connect servers will see an abbreviated dropdown menu

This will open a modal to display the response of the update check.

If there's an update available, you'll see the following.

04a check for update response modal

Review the changelog – make note of any potential breaking changes and known issues before continuing with your update.

08 changelog opened

Click the Continue to jump to the update confirmation step.

10a post continue click update confirmation closeup

Confirm and start update to start the download process.

Once the download is complete refresh the Unraid webgui.

Notice the Reboot Required to Update message in the top left header. Click that button once you're ready to reboot.

13a reboot required for update

Then lastly, confirm the reboot

14 reboot now to update

Option 2 – Prereleases / Changing release branch

Many of our users like to run our release candidates (RCs) which are on our "next" branch of releases.

If you want to test these releases. This will be the method for you.

Go to Tools → Update OS or click Check for Update in the top-right dropdown, then choose More Options in the modal that appears.

Clicking one of these links will then take you to account.unraid.net to look at new OS release options.

  1. The new updater has an account sign in requirement for downloading “next” releases. We made this change to ensure that users don’t accidentally swap into the next branch and that everyone running a prerelease has a forum account to provide feedback.
  2. The new updater now supports multiple releases of a “mainline” branch. For example, we can potentially release a Stable 6.12.x along with a Stable 6.13.x release.
15 account update os

For each release you'll be able to view the changelog and continue with the update.

Again, always be sure to closely read the changelog for any breaking changes and known issues.

You'll continue and confirm the update just like how it's detailed in option 1.

16 account update os changelog

Configure automated checks to be scheduled via Settings → Notification Settings

If configured, when a new version is detected, click the “Updates Available” link in the top left of the header.

05a update available ui in header closeup

Ignoring a specific release

If using the Check for Update button in the top-right dropdown of the webgui and there's a release available; you may opt to ignore it.

Simply toggle the switch in the update check modal then close the modal.

The release will then be ignored until the next time you reboot your server.

07a ignore release checked

Stop ignoring a release

This is done by using the Check for Update button in the top-right dropdown of the webgui, then if there are no releases available, you'll be presented an option to stop ignoring a release.

11a check for update response modal ignored releases

Changes to Downgrade OS

We’ve also improved the downgrade feature and moved it to its own page at Tools → Downgrade OS. This new page allows for easier rollbacks to your previously installed release and has a much better interface to walk through the process. Be sure to read the release notes both current and previous versions before rolling back, as incompatibilities or manual changes could be needed before downgrading.

17 tools downgrade

Questions? Comments?

Let us know in the Unraid forums!

Edited Feb. 08, 2024 – Based on feedback for the original release of the new Update OS tool, we've changed how the tool is used in the Unraid webgui. This blog has been updated to reflect these changes.