Flatpak: Difference between revisions

(6 intermediate revisions by the same user not shown)

Line 9:

{{file|3=services.flatpak.enable = true;|name=/etc/nixos/configuration.nix|lang=nix}}

=== Per-User ===

If you'd rather make Flatpak available to a specific user, add <code>flatpak</code> to that user's packages~~. To be able to install Flatpaks graphically, add the <code>gnome-software</code> package. The result will look something like this:~~

If you'd rather make Flatpak available to a specific user, add <code>flatpak</code> to that user's packages

{{file|3=users.users."user" = {

packages = with pkgs; [

flatpak

~~gnome-software~~

];

};|name=/etc/nixos/configuration.nix|lang=nix}}

Line 31:

Line 30:

In the event of a Nix rollback, both modules will reinstall the previously declared Flatpak packages

==== [https://github.com/gmodena/nix-flatpak nix-flatpak] ====

Line 37:

Line 38:

Flatpak packages are not cached in the Nix store

It supports flakes or [~~https://github.com/nix-community/home-manager~~ home-manager], but doesn't support non-flakes only

It supports flakes or [[Home Manager|home-manager]], but doesn't support non-flakes only

For more details, see [https://github.com/gmodena/nix-flatpak/discussions/168 nix-flatpak/discussions/168]

==== [https://github.com/in-a-dil-emma/declarative-flatpak declarative-flatpak] ====

A congruent approach to Flatpak management where changes are designed to be atomic, ensuring that either they succeed or nothing happens. This module uses a temporary installation and then overwrites the current one.

It supports non-flake, flakes, and [~~https://github.com/nix-community/home-manager~~ home-manager]

It supports non-flake, flakes, and [[Home Manager|home-manager]]

For more details, see [https://github.com/in-a-dil-emma/declarative-flatpak/issues/44 declarative-flatpak/issues/44]

=== Imperative ===

To manage Flatpak imperatively, you can use [https://docs.flatpak.org/en/latest/using-flatpak.html the <code>flatpak</code> CLI] ([https://docs.flatpak.org/en/latest/flatpak-command-reference.html <code>flatpak</code> CLI Reference Documentation])

==== Example ====

==== Terminal User Interface ====

To manage Flatpak imperatively, you can use [https://docs.flatpak.org/en/latest/using-flatpak.html the <code>flatpak</code> command] ([https://docs.flatpak.org/en/latest/flatpak-command-reference.html <code>flatpak</code> Command Reference Documentation])

===== Example =====

<syntaxhighlight lang="console">$ flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo

$ flatpak update

Line 55:

Line 60:

$ flatpak install flathub com.github.tchx84.Flatseal

$ flatpak run com.github.tchx84.Flatseal</syntaxhighlight>

==== Graphical User Interface ====

To install Flatpaks graphically, you can use [https://apps.gnome.org/en-GB/Software/ the GNOME Software Application] ([https://search.nixos.org/packages?show=gnome-software <code>gnome-software</code> in nixpkgs])

'''Note''': installing Flatpaks through it is imperative

==== Configure Repositories Globally ====

To automatically configure Flatpak repositories for all users, this ~~needs to be added~~ to <code>configuration.nix</code>:{{file|3=systemd.services.flatpak-repo = {

{{Warning|This assumes you are not installing Flatpak packages [https://wiki.nixos.org/wiki/Flatpak#Declarative declaratively] (using [https://wiki.nixos.org/wiki/Flatpak#nix-flatpak nix-flatpak] or [https://wiki.nixos.org/wiki/Flatpak#declarative-flatpak declarative-flatpak])

Otherwise, the following section could conflict with them

If you are, prefer using [https://wiki.nixos.org/wiki/Flatpak#nix-flatpak nix-flatpak]'s <code>services.flatpak.remotes</code> or [https://wiki.nixos.org/wiki/Flatpak#declarative-flatpak declarative-flatpak]'s <code>services.flatpak.remotes</code> instead}}

To automatically configure Flatpak repositories for all users, one can add this snippet to <code>configuration.nix</code>:{{file|3=systemd.services.flatpak-repo = {

wantedBy = [ "multi-user.target" ];

path = [ pkgs.flatpak ];

Line 91:

Line 106:

=== Emulate Flatpaks of different architecture ===

It is possible to install and run Flatpaks which were compiled for a different platform. In this example we ~~start~~ the application ''Metronome~~'' as~~ aarch64 Flatpak ~~on a~~ x86_64 ~~host~~:<syntaxhighlight lang="console">

It is possible to install and run Flatpaks which were compiled for a different platform.

$ flatpak install ~~--user --arch=aarch64~~ flathub com.adrienplazas.Metronome

$ flatpak run ~~--user~~ com.adrienplazas.Metronome

In this example we imperatively install the application "Metronome" <code>aarch64</code> Flatpak package and run it (regardless of the architecture of the host, but in that case, it was <code>x86_64</code>):<syntaxhighlight lang="console">$ flatpak install flathub com.adrienplazas.Metronome --arch=aarch64

</syntaxhighlight>To support emulation with Qemu, [[QEMU#Run binaries of different architecture|following Binfmt configuration]] is required.

$ flatpak run com.adrienplazas.Metronome</syntaxhighlight>To support emulation with Qemu, [[QEMU#Run binaries of different architecture|following Binfmt configuration]] is required.

== Troubleshooting ==

@@ Line 9: / Line 9: @@
 {{file|3=services.flatpak.enable = true;|name=/etc/nixos/configuration.nix|lang=nix}}
 === Per-User ===
-If you'd rather make Flatpak available to a specific user, add <code>flatpak</code> to that user's packages. To be able to install Flatpaks graphically, add the <code>gnome-software</code> package. The result will look something like this:
+If you'd rather make Flatpak available to a specific user, add <code>flatpak</code> to that user's packages
 {{file|3=users.users."user" = {
      packages = with pkgs; [
        flatpak
-      gnome-software
      ];
    };|name=/etc/nixos/configuration.nix|lang=nix}}
@@ Line 31: / Line 30: @@
 In the event of a Nix rollback, both modules will reinstall the previously declared Flatpak packages
+{{Expand|reason=Exemples are missing|scope=section}}
 ==== [https://github.com/gmodena/nix-flatpak nix-flatpak] ====
@@ Line 37: / Line 38: @@
 Flatpak packages are not cached in the Nix store
-It supports flakes or [https://github.com/nix-community/home-manager home-manager], but doesn't support non-flakes only
+It supports flakes or [[Home Manager|home-manager]], but doesn't support non-flakes only
+<small>For more details, see [https://github.com/gmodena/nix-flatpak/discussions/168 nix-flatpak/discussions/168]</small>
 ==== [https://github.com/in-a-dil-emma/declarative-flatpak declarative-flatpak] ====
 A congruent approach to Flatpak management where changes are designed to be atomic, ensuring that either they succeed or nothing happens. This module uses a temporary installation and then overwrites the current one.
-It supports non-flake, flakes, and [https://github.com/nix-community/home-manager home-manager]
+It supports non-flake, flakes, and [[Home Manager|home-manager]]
 <small>For more details, see [https://github.com/in-a-dil-emma/declarative-flatpak/issues/44 declarative-flatpak/issues/44]</small>
 === Imperative ===
-To manage Flatpak imperatively, you can use [https://docs.flatpak.org/en/latest/using-flatpak.html the <code>flatpak</code> CLI] ([https://docs.flatpak.org/en/latest/flatpak-command-reference.html <code>flatpak</code> CLI Reference Documentation])
-==== Example ====
+==== Terminal User Interface ====
+To manage Flatpak imperatively, you can use [https://docs.flatpak.org/en/latest/using-flatpak.html the <code>flatpak</code> command] ([https://docs.flatpak.org/en/latest/flatpak-command-reference.html <code>flatpak</code> Command Reference Documentation])
+===== Example =====
 <syntaxhighlight lang="console">$ flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
 $ flatpak update
@@ Line 55: / Line 60: @@
 $ flatpak install flathub com.github.tchx84.Flatseal
 $ flatpak run com.github.tchx84.Flatseal</syntaxhighlight>
+==== Graphical User Interface ====
+To install Flatpaks graphically, you can use [https://apps.gnome.org/en-GB/Software/ the GNOME Software Application] ([https://search.nixos.org/packages?show=gnome-software <code>gnome-software</code> in nixpkgs])
+<small>'''Note''': installing Flatpaks through it is imperative</small>
 ==== Configure Repositories Globally ====
-To automatically configure Flatpak repositories for all users, this needs to be added to <code>configuration.nix</code>:{{file|3=systemd.services.flatpak-repo = {
+{{Warning|This assumes you are not installing Flatpak packages [https://wiki.nixos.org/wiki/Flatpak#Declarative declaratively] (using [https://wiki.nixos.org/wiki/Flatpak#nix-flatpak nix-flatpak] or [https://wiki.nixos.org/wiki/Flatpak#declarative-flatpak declarative-flatpak])
+Otherwise, the following section could conflict with them
+If you are, prefer using [https://wiki.nixos.org/wiki/Flatpak#nix-flatpak nix-flatpak]'s <code>services.flatpak.remotes</code> or [https://wiki.nixos.org/wiki/Flatpak#declarative-flatpak declarative-flatpak]'s <code>services.flatpak.remotes</code> instead}}
+To automatically configure Flatpak repositories for all users, one can add this snippet to <code>configuration.nix</code>:{{file|3=systemd.services.flatpak-repo = {
      wantedBy = [ "multi-user.target" ];
      path = [ pkgs.flatpak ];
@@ Line 91: / Line 106: @@
 === Emulate Flatpaks of different architecture ===
-It is possible to install and run Flatpaks which were compiled for a different platform. In this example we start the application ''Metronome'' as aarch64 Flatpak on a x86_64 host:<syntaxhighlight lang="console">
+It is possible to install and run Flatpaks which were compiled for a different platform.
-$ flatpak install --user --arch=aarch64 flathub com.adrienplazas.Metronome
-$ flatpak run --user com.adrienplazas.Metronome
+In this example we imperatively install the application "Metronome" <code>aarch64</code> Flatpak package and run it (regardless of the architecture of the host, but in that case, it was <code>x86_64</code>):<syntaxhighlight lang="console">$ flatpak install flathub com.adrienplazas.Metronome --arch=aarch64
-</syntaxhighlight>To support emulation with Qemu, [[QEMU#Run binaries of different architecture|following Binfmt configuration]] is required.
+$ flatpak run com.adrienplazas.Metronome</syntaxhighlight>To support emulation with Qemu, [[QEMU#Run binaries of different architecture|following Binfmt configuration]] is required.
 == Troubleshooting ==