Getting Started

Kinoite is designed to be easy and straightforward to use, and specialist knowledge should generally not be required. However, Kinoite is built differently from other operating systems, and there are therefore some things that it is useful to know.

Kinoite has different options for installing software, compared with a standard Fedora Workstation (or other package-based Linux distributions). These include:

  • Flatpak apps: this is the primary way that (GUI) apps get installed on Kinoite.

  • Toolbox: Used primarily for CLI apps; development, debugging tools etc.

  • Package layering: The rpm-ostree tool used for host updates is a full hybrid image/package system. By default the system operates in pure image mode, but package layering is useful for things like libvirt, drivers, etc.

For information on Flatpak and package layering, see below.

See the dedicated toolbox page to get started with it.


Flatpak is the primary way that apps can be installed on Kinoite (for more information, see Flatpak works out of the box in Fedora Kinoite, and Fedora provides a small (but growing) collection of apps that can be installed.

The other main source of Flatpak apps is Flathub, which provides a large repository of Flatpak apps that can be installed.

Setting up Flathub

To setup Flathub on Fedora Kinoite, open the Flathub setup page for Fedora and click the “Flathub repository file” button to download the Flathub configuration.

sfg flathub fedora
Figure 1. Fedora quick setup page

A popup window will show a download option for the file. The “Open with” option should show “Discover (default)”. Click on the “OK” button to start the download.

sfg flathub download
Figure 2. Flathub download options

After the download is complete, a new window will open showing the Flathub repository. To start the installation of the Flathub repository, click on the “Install” button (1). You will need to authenticate in the following window to proceed with the installation.

sfg flathub install
Figure 3. Flathub install window

After the repository installation process is complete, the window will be updated to show a “Remove" button in place of the “Install” button.

Installing Flatpak apps from Flathub

Once the Flathub repository has been setup, it can be used to install Flatpak apps. This can be done directly from the Discover app, or apps can be browsed on the Flathub website.

If you choose to install apps from the Flathub website, clicking "Install" will download a file which will be opened by the Discover app, which can then be used to install the app. For example, to install LibreOffice, you first search for and open the LibreOffice page, and then press the “Install” button.

After clicking the “Install” button, a download information window will be shown. Verify the correct Flatpak has been downloaded and then click on the “OK” button to begin installing the LibreOffice application.

sfg libreoffice install
Figure 4. LibreOffice Flatpak download

Once the Flatpak is downloaded, the Discover application will open a new window with an “Install” button. Click this button to begin installation.

Flatpak command line

In addition to using the Software app to install Flatpak apps, it is also possible to use the flatpak command line interface. See the Flatpak documentation for how to do this.

Package layering

Package layering works by modifying your Kinoite installation. As the name implies, it works by extending the packages from which Kinoite is composed.

Good examples of packages to be layered would be:

  • fish: An alternative Unix shell

  • sway: A Wayland tiling compositor

  • libvirt: The libvirt daemon

Most (but not all) RPM packages provided by Fedora can be installed on Kinoite using this method.

Currently, using package layering creates a new "deployment", or bootable filesystem root. It does not affect your current root. This preserves rollback and the transactional model, but means that the system must be rebooted after a package has been layered. If you don’t want to reboot your system for switching to the new deployment, you can use an experimental rpm-ostree ex apply-live command to update the filesystem to see changes from new deployment, but it’s generally expected that you use package layering sparingly, and use flatpak and dnf install inside a toolbox etc.

Package layering is generally done from the command line. However, the Software application does rely on it for installing a small number of apps that are currently difficult to install as Flatpaks.

Installing packages

Packages can be installed on Kinoite using:

$ rpm-ostree install <package name>

This will download the package and any required dependencies, and recompose your Kinoite image with them. rpm-ostree uses standard Fedora package names, which can be searched using DNF (this is not available on a Kinoite host, but can be used in a toolbox).

Once a package has been installed in this manner, it will be kept up-to-date as new versions are released and as the base operating system is updated.

Replacing packages

In some scenarios, you may want to test out a new version of podman or kernel or other packages that live on the host. The rpm-ostree override command can be used to replace a package with a different version. You can download the package locally and run:

$ rpm-ostree override replace <path to package>

Or you can override packages without downloading using links from koji or bodhi. For example:

$ rpm-ostree override replace

You may also use override remove to effectively "hide" packages; they will still exist in the underlying base layer, but will not appear in the booted root.

Removing and replacing packages using package layering is not generally recommended. For more information, see the rpm-ostree documentation.