Updating UnofficialOS

UnofficialOS can be updated "Over the Air" (OTA) or by manually downloading an update .tar file, adding to your device storage and rebooting.

Option 1: OTA Update

If your device has access to the internet you can update UnofficialOS directly from EmulationStation.

1. In EmulationStation open the main menu by pressing the ++"Start"++ button on your controller.
2. Select System Settings
3. Scroll to the System Update header and select Start Update

Option 2: Manual Update

If you device does not have access to the internet you can still update manually

1. Download the latest update (.tar) of UnofficialOS for your device from the releases page.
   • You'll find download links for each device/platform we support under the "Update Package Downloads" header.
   • Make sure to download the correct .tar file for your device. For example; if you are installing UnofficialOS on a RG351P you would download the UnofficialOS-RK3326 file.
   • If you have any questions you can check the Device Support section to confirm which .tar you should download for your specific device.
2. Copy the update to your device's update share.
   • via SCP to /storage/.update
   • via Samba to "update"
3. Reboot the device, and the update will begin automatically.

Option 3: Development build

!!! warning "Development builds do not contain credentials for scraping and RetroAchievements, so these functions will not work!"

• find a build you need in the UnofficialOS Discord Announcements channel
• a link to dev builds are posted when available
• .tar and .img.gz files are good for updating.
  .tar is a bit faster to update than .img.gz
.zip needs to be unzipped

Update process is similar to manual update:

1. Download (and unzip if needed) the build, you need .tar or .img.gz file
2. Copy the update to your device's update share.
   • via SCP to /storage/.update
   • via Samba to "update"
3. Reboot the device, and the update will begin automatically.