Skip to content

OTA

Jump to bottom
Rinigus edited this page Jul 18, 2026 · 1 revision

OTA Update Instructions

It is recommended to perform OTA updates using an SSH connection to the phone from a PC. The phone display may refuse to turn on during or after the update. When updating over SSH, you can follow the update progress and reboot the phone safely after it finishes.

OTA updates for this port are supported via command line.

Preparation

  • Back up Sailfish OS user files to a microSD card or another device before updating.

  • Updates are tested between consecutive Sailfish OS releases. Before skipping releases, check the Sailfish OS Forum and read the Nagara release notes for all releases that you plan to skip.

  • Enable Developer tools on the phone:

    • Open Settings / Developer tools
    • Enable Developer tools
    • Set the password
    • Enable Remote connection if updating via SSH

  • Open a shell as the normal defaultuser user, preferably via SSH.

  • Check that the expected repositories are enabled:

ssu lr

When coming from Sailfish OS 5.0.0.77, before switching to 5.1, the expected repositories are similar to the example below.

Enabled repositories (global):
 - adaptation-common           ... https://releases.jolla.com/releases/5.0.0.77/jolla-hw/adaptation-common/aarch64/
 - adaptation-community        ... https://repo.sailfishos.org/obs/nemo:/testing:/hw:/sony:/nagara:/5.0/sailfishos_5.0_aarch64/
 - adaptation-community-common ... https://repo.sailfishos.org/obs/nemo:/testing:/hw:/common/sailfishos_5.0_aarch64/
 - apps                        ... https://releases.jolla.com/jolla-apps/5.0.0.77/aarch64/
 - hotfixes                    ... https://releases.jolla.com/releases/5.0.0.77/hotfixes/aarch64/
 - jolla                       ... https://releases.jolla.com/releases/5.0.0.77/jolla/aarch64/

Enabled repositories (user):
 - sailfishos-chum  ... https://repo.sailfishos.org/obs/sailfishos:/chum/5.0_aarch64/
 - store            ... https://store-repository.jolla.com/xqct54/aarch64/?version=5.0.0.77

The store URL above is for Xperia 1 IV. On Xperia 5 IV, it should use xqcq54 instead of xqct54.

Make sure that all repositories in the global section are present and that store is present in the user section. The sailfishos-chum repository is optional.

The important port repositories are adaptation-community and adaptation-community-common. They must point to repo.sailfishos.org and to the nemo:/testing:/hw:/... projects. For Sailfish OS 5.0, the Nagara repository is nemo:/testing:/hw:/sony:/nagara:/5.0. After switching to Sailfish OS 5.1 below, it should become nemo:/testing:/hw:/sony:/nagara:/5.1.

If adaptation-community or adaptation-community-common is missing or points to a Jolla store URL, install the community-adaptation-testing package for your current Sailfish OS version from OBS. When coming from Sailfish OS 5.0.0.77, download the latest community-adaptation-testing-*.aarch64.rpm from:

https://repo.sailfishos.org/obs/nemo:/testing:/hw:/sony:/nagara:/5.0/sailfishos_5.0_aarch64/aarch64/

Then install it on the phone as root:

devel-su zypper in community-adaptation-testing-*.aarch64.rpm

Zypper may complain that the package is not signed. Accept the package if it was downloaded from the OBS repository above. After installation, run ssu lr again and verify that the missing repositories are listed.

  • Before switching releases, make sure the current installation is fully updated:
devel-su zypper ref
devel-su zypper up

If kernel, boot image, device configuration, or other adaptation packages were updated, reboot before continuing.

Update Repositories

Refresh the current repositories, update all packages for the current release, and make sure the correct device configuration package is installed.

Install exactly one of the two device configuration packages below. Choose the package that matches your device.

For Xperia 1 IV:

devel-su zypper ref
devel-su zypper up
devel-su zypper in patterns-sailfish-device-configuration-xqct54

For Xperia 5 IV:

devel-su zypper ref
devel-su zypper up
devel-su zypper in patterns-sailfish-device-configuration-xqcq54

Switch Sailfish OS to the target release:

ssu release 5.1.0.11
ssu lr

Check the repository list again. For the 5.1 update, the port repositories should point to:

 - adaptation-community        ... https://repo.sailfishos.org/obs/nemo:/testing:/hw:/sony:/nagara:/5.1/sailfishos_5.1_aarch64/
 - adaptation-community-common ... https://repo.sailfishos.org/obs/nemo:/testing:/hw:/common/sailfishos_5.1_aarch64/

If you have many OpenRepos repositories enabled, it is recommended to disable them before the update. version --dup will try to isolate repositories, but fewer enabled third-party repositories reduces the chance of conflicts.

Update

If all required repositories are configured correctly, perform the update:

devel-su zypper clean -a
devel-su zypper ref -f

devel-su version --dup
# If the command above fails, fix the reported issue and try it again.

Before rebooting, make sure the correct device configuration package is installed. Install exactly one of the two packages below. Choose the package that matches your device.

For Xperia 1 IV:

devel-su zypper in patterns-sailfish-device-configuration-xqct54
sync

For Xperia 5 IV:

devel-su zypper in patterns-sailfish-device-configuration-xqcq54
sync

Reboot after the update finishes.

devel-su reboot

If the display does not turn on with the power button and you do not have SSH access, you will have to estimate when the update has finished. To power off the phone, press and hold the power button until the red LED turns on. Release the button and wait until the phone shuts down. Then start it again with the power button.

On the first boot after an update, the phone may reboot automatically once if the kernel or boot image was updated.

Clone this wiki locally