2023-01-20 10:41:00 +00:00
|
|
|
<!-- Do not edit this file directly, edit its companion .md instead
|
|
|
|
|
and regenerate this file using nixos/doc/manual/md-to-db.sh -->
|
|
|
|
|
<chapter xmlns="http://docbook.org/ns/docbook" xmlns:xlink="http://www.w3.org/1999/xlink" xml:id="module-services-flatpak">
|
|
|
|
|
<title>Flatpak</title>
|
|
|
|
|
<para>
|
|
|
|
|
<emphasis>Source:</emphasis>
|
|
|
|
|
<filename>modules/services/desktop/flatpak.nix</filename>
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
<emphasis>Upstream documentation:</emphasis>
|
|
|
|
|
<link xlink:href="https://github.com/flatpak/flatpak/wiki">https://github.com/flatpak/flatpak/wiki</link>
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Flatpak is a system for building, distributing, and running
|
|
|
|
|
sandboxed desktop applications on Linux.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
To enable Flatpak, add the following to your
|
|
|
|
|
<filename>configuration.nix</filename>:
|
|
|
|
|
</para>
|
|
|
|
|
<programlisting>
|
|
|
|
|
services.flatpak.enable = true;
|
2020-04-24 23:36:52 +00:00
|
|
|
</programlisting>
|
2023-01-20 10:41:00 +00:00
|
|
|
<para>
|
|
|
|
|
For the sandboxed apps to work correctly, desktop integration
|
|
|
|
|
portals need to be installed. If you run GNOME, this will be handled
|
|
|
|
|
automatically for you; in other cases, you will need to add
|
|
|
|
|
something like the following to your
|
|
|
|
|
<filename>configuration.nix</filename>:
|
|
|
|
|
</para>
|
|
|
|
|
<programlisting>
|
|
|
|
|
xdg.portal.extraPortals = [ pkgs.xdg-desktop-portal-gtk ];
|
2020-04-24 23:36:52 +00:00
|
|
|
</programlisting>
|
2023-01-20 10:41:00 +00:00
|
|
|
<para>
|
|
|
|
|
Then, you will need to add a repository, for example,
|
|
|
|
|
<link xlink:href="https://github.com/flatpak/flatpak/wiki">Flathub</link>,
|
|
|
|
|
either using the following commands:
|
|
|
|
|
</para>
|
|
|
|
|
<programlisting>
|
|
|
|
|
$ flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo
|
|
|
|
|
$ flatpak update
|
|
|
|
|
</programlisting>
|
|
|
|
|
<para>
|
|
|
|
|
or by opening the
|
|
|
|
|
<link xlink:href="https://flathub.org/repo/flathub.flatpakrepo">repository
|
|
|
|
|
file</link> in GNOME Software.
|
|
|
|
|
</para>
|
|
|
|
|
<para>
|
|
|
|
|
Finally, you can search and install programs:
|
|
|
|
|
</para>
|
|
|
|
|
<programlisting>
|
|
|
|
|
$ flatpak search bustle
|
|
|
|
|
$ flatpak install flathub org.freedesktop.Bustle
|
|
|
|
|
$ flatpak run org.freedesktop.Bustle
|
|
|
|
|
</programlisting>
|
|
|
|
|
<para>
|
|
|
|
|
Again, GNOME Software offers graphical interface for these tasks.
|
|
|
|
|
</para>
|
2020-04-24 23:36:52 +00:00
|
|
|
</chapter>
|
