Link Search Menu Expand Document

Software Packaging

Sailfish OS uses modern software packaging systems to allow controlled over-the-air updates. A given device will be registered for a specific variation of the operating system, where the variant specifies which packages (and which versions of which packages) that device should have access to.

Device Variants

Each device variant is defined by a pattern file which describes the initial filesystem content and packages to be installed in the device. Device variants can be defined for different regions, different operators, different device platforms, or any combination of those or other variation inputs. Individual variants can have entirely different content or packages defined, and the patterns are defined in such a way to maximise reuse capability while minimising maintenance overhead, while enforcing variant segregation at both image-creation and device-update stages of the product lifecycle.

The variation system also allows for vendor-specific licenses, artwork, and other content to be preinstalled on the devices they ship, via package inclusion or via a secure filesystem partition.

Please see the documentation about SSU and about the Store for more information about the deployment services for Sailfish OS and how updates are controlled for specific variants.


Sailfish OS uses RPM packages to handle native software distribution, which can be build using the SDK. PackageKit with libzypp backend are used as the middleware components to handle the on-device RPM database. It supports binary diffing and delta-rpm package upgrades to minimise bandwidth required for package upgrades.

RPM packaging Guidelines

We are following quite closely Fedora’s packaging guidelines, which you can read from

Recent changes in Sailfish OS packaging

Differences to Fedora guidelines

  • For tar_git based packages the Source: line should be in format %{name}-%{version}.tar.bz2


Sailfish OS with Android AppSupport, can use applications in apk format from Android. One core service provided by Sailfish OS is called apkd, which mediates installation, deinstallation, upgrades and other interaction with apk packages within Sailfish OS.


Sailfish OS Cheat Sheet lists the most common package handling commands.