# Updates

Source: https://getorbitnet.com/guides/updates/

**Settings → Updates** shows the installed version and whether an update is
available. *Not yet confirmed on a PS5:* updating, and going back to the
previous version when an update fails. They have only been checked in
development so far.

1. Select **Check for updates**.
2. If one is available, select **Update OrbitNet** and confirm.
3. OrbitNet downloads the new app and background service together, and checks
   them before using them.
4. The app closes so the update can replace it. The background service starts
   the new version and watches it while ShadowMount adds the new app.
5. Open OrbitNet again after the update. You don't need to restart the PS5.

Finish playing first: OrbitNet won't update during a game, and you can't
start anything new in rooms while an update is being prepared. Leave Payload
Manager and ShadowMount running. If the app is still in use, OrbitNet leaves it
as it is; it never closes a game, uninstalls anything or changes ShadowMount's
settings to force an update.

## If an update fails

| You see | What to do |
| --- | --- |
| Finish playing before updating OrbitNet | Leave your game, then update |
| Free some space, then check for updates again | Free some space and check again. Unfinished downloads are removed; finished, checked files may be kept for the next try or for recovery |
| Restart OrbitNet, then check for updates again | Close OrbitNet, open it again, then check for updates |
| Update failed | Check that Payload Manager and ShadowMount are running. Close OrbitNet and check for updates again. Your current app isn't replaced until the new version has been checked and ShadowMount has let go of the old one |
| Previous version restored | The new version didn't start properly, so OrbitNet went back to the previous app, background service and their saved settings. It won't offer that version again |
| OrbitNet can't go back to that version | Keep the update files and ask for help (see [Getting help](https://getorbitnet.com/guides/help/)). OrbitNet won't switch versions when something it needs to do that safely is missing or has changed, or while the old background service is still running |

An update only counts as done once the new version has kept running, with
its app added to the home screen, for at least a minute. Until then the
previous version watches over it, including if the new one fails before it
starts. If the new version fails to start again and again, OrbitNet also goes
back to the last version that worked. A loader saying "OK" isn't enough to
count an update as done.

If the PS5 loses power during an update, start the OrbitNet background
service that last worked through Payload Manager. It finishes or undoes the
update before it opens your account. Don't delete OrbitNet's `updates` folder
or its update records to force it. It won't replace the app while another
copy of the background service is running.
