Improve this doc

Self-service updates

Which devices and versions are supported?

Since we periodically release updates and improvements to resinOS (the host OS running on all devices), we encourage you to keep your device up to date. We offer self-service host OS updates between 2.x versions, from 1.x to 2.x versions, and between 1.x versions.

Note: ResinOS 1.x to 2.x updates limit the amount of data you can have in your application's /data folder to about 170MB (compressed). If you have more data, the update will fail and your device won't be modified.

Supported device types:

  • For the Raspberry Pi series, self-service updates are available from resinOS versions 1.8.0 and upwards (including 2.x versions) to any versions after resinOS 2.2.0.
  • For BeagleBone devices, you can update resinOS 1.8.0 through 1.26.0 to the transitional 1.30.1 version, and from 1.30.1 and upwards (including 2.x versions) to version 2.2.0 and newer.
  • For Intel NUC and UP Boards, you can update all 2.x versions to 2.2.0 and newer.
  • IOT2000 can be updated from all available versions to all newer versions.
  • Jetson TX2 can be updated starting from resinOS 2.7.4+rev1 to all newer versions.
  • QEMU devices (both 32 and 64-bit versions) can be updated starting from resinOS 2.9.3+rev1 to all newer versions.
  • TS-4900 can be updated starting from resinOS 2.4.1+rev1 to all newer versions.

At the moment, self-service updates are only available for production resinOS versions. If you need updates for development and beta versions, please contact support or start a thread on the forums.

For device types and resinOS versions that are not yet supported, please contact us on the forums. We are continuously expanding the range of versions and types that can be updated.

Running an update

To run an update, navigate to your device's Actions tab, click Update ResinOS, and select the version of resinOS you would like to update to:

Note: Updates to the supervisor,'s agent on the device, are handled in conjuction with host OS updates. If you need to update the supervisor separately from the host OS, please contact us for assistance.

You will see a progress bar that marks the steps completed for the update. Some steps that take longer, such as the device downloading the new OS image, may make the progress bar appear stuck. This doesn't mean anything has gone wrong with your update. We are working on making the update process more informative.

Update time can vary significantly, depending on the speed of your network, the speed of your SD card (or other storage medium), and your device performance.

If your resinOS update fails for any reason, the device should still be recoverable. For devices running resinOS 2.x, the user application should still be running normally, and the reasons for failure can be examined throught the update logs at mnt/data/resinhup/. If you have any issues, please contact us on the troubleshooting section of the forums.

You can learn more about what exactly goes on during the update process here.