Flatpak - Revision history

Blastboom Strice: Shorten /Uninstalling glitched application and wipe its data/ to /Uninstalling an application and wiping its data/

2026-05-21T12:38:09Z

Shorten Uninstalling glitched application and wipe its data: to Uninstalling an application and wiping its data

← Older revision		Revision as of 12:38, 21 May 2026
Line 126:		Line 126:
	If you have issues with cursors or themes in general, take a look at [[Fonts#Flatpak_applications_can't_find_system_fonts]]		If you have issues with cursors or themes in general, take a look at [[Fonts#Flatpak_applications_can't_find_system_fonts]]

	=== Uninstalling ~~glitched~~ application and ~~wipe~~ its data ===		=== Uninstalling an application and wiping its data ===
	{{Warning\|This involves deleting application data of flatpak applications, make sure to keep backed up any flatpak application data you want before proceeding.}}		{{Warning\|This involves deleting application data of flatpak applications, make sure to keep backed up any flatpak application data you want before proceeding.}}

Blastboom Strice: Add /Uninstalling glitched application and wipe its data/

2026-05-21T12:35:46Z

Add Uninstalling glitched application and wipe its data

← Older revision		Revision as of 12:35, 21 May 2026
Line 125:		Line 125:

	If you have issues with cursors or themes in general, take a look at [[Fonts#Flatpak_applications_can't_find_system_fonts]]		If you have issues with cursors or themes in general, take a look at [[Fonts#Flatpak_applications_can't_find_system_fonts]]

			=== Uninstalling glitched application and wipe its data ===
			{{Warning\|This involves deleting application data of flatpak applications, make sure to keep backed up any flatpak application data you want before proceeding.}}

			Sometimes, flatpak applications may glitch (like fonts in Flatseal<ref>https://github.com/tchx84/Flatseal/issues/501</ref>) and wiping their data may solve the issue. To do so, you have two options.

			==== Option 1: Delete application and its data in a single command ====
			This is useful if you have installed the flatpak application '''imperatively'''. Use the <code>--delete-data</code> flag when uninstalling the offending application, (like <code>flatpak uninstall <application> --delete-data</code> ). Then re-install the offending application (like <code>flatpak install <application></code> ).

			==== Option 2: Delete application and then delete its data ====
			This is useful if you have set up flatpak '''declaratively'''<ref>[[Flatpak#Declarative]]</ref>. First remove the application from your configuration and rebuild. Then run <code>flatpak uninstall --unused --delete-data</code> to both delete '''all''' leftover applications and wipe the data of anything previously deleted. This will ask you to delete the data of each application individually, delete only the data of the offending application. Then re-add the offending application in your configuration and rebuild.

	[[Category:Software]]		[[Category:Software]]
	[[Category:NixOS Manual]]		[[Category:NixOS Manual]]

Claymichaels: /* Declarative */ "this section needs to be expanded" Template has a typo.

2025-12-31T20:52:38Z

Declarative: "this section needs to be expanded" Template has a typo.

← Older revision		Revision as of 20:52, 31 December 2025
Line 40:		Line 40:
	In the event of a Nix rollback, both modules will reinstall the previously declared Flatpak packages		In the event of a Nix rollback, both modules will reinstall the previously declared Flatpak packages

	{{Expand\|reason=~~Exemples~~ are missing\|scope=section}}		{{Expand\|reason=Examples are missing\|scope=section}}

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

Minion: feat: add directories to persist with impermanence

2025-11-20T13:12:40Z

feat: add directories to persist with impermanence

← Older revision		Revision as of 13:12, 20 November 2025
Line 23:		Line 23:
	{{file\|3=export XDG_DATA_DIRS=$XDG_DATA_DIRS:/usr/share:/var/lib/flatpak/exports/share:$HOME/.local/share/flatpak/exports/share\|name=.profile\|lang=}}		{{file\|3=export XDG_DATA_DIRS=$XDG_DATA_DIRS:/usr/share:/var/lib/flatpak/exports/share:$HOME/.local/share/flatpak/exports/share\|name=.profile\|lang=}}
	This is also required when installing <code>flatpak</code> on a per-user basis.		This is also required when installing <code>flatpak</code> on a per-user basis.

			=== With Impermanence ===
			If you're using [[Impermanence]], you'll need to make sure you persist the directories that flatpak will be using

			* <code>/var/lib/flatpak</code> (for system configuration, repositories, etc.)
			* <code>~/.var/app</code> (for app data)
			* <code>~/.local/share/flatpak</code> (for user-specific configuration)

			The directories in your home (starting with <code>~</code>) will need to be persisted for every user who will use flatpak

	== Usage ==		== Usage ==

Malix: /* Declarative */ add exemples request

2025-09-16T17:52:14Z

Declarative: add exemples request

← Older revision		Revision as of 17:52, 16 September 2025
Line 30:		Line 30:

	In the event of a Nix rollback, both modules will reinstall the previously declared Flatpak packages		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] ====		==== [https://github.com/gmodena/nix-flatpak nix-flatpak] ====

Malix: enhance: links

2025-08-11T15:19:45Z

enhance: links

← Older revision		Revision as of 15:19, 11 August 2025
Line 36:		Line 36:
	Flatpak packages are not cached in the Nix store		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>		<small>For more details, see [https://github.com/gmodena/nix-flatpak/discussions/168 nix-flatpak/discussions/168]</small>
Line 43:		Line 43:
	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.		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>		<small>For more details, see [https://github.com/in-a-dil-emma/declarative-flatpak/issues/44 declarative-flatpak/issues/44]</small>
Line 60:		Line 60:

	==== Graphical User Interface ====		==== 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?~~channel=unstable&~~show=gnome-software~~&type=packages~~ <code>gnome-software</code> in nixpkgs])		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>		<small>'''Note''': installing Flatpaks through it is imperative</small>

Malix: /* Configure Repositories Globally */

2025-08-08T23:20:35Z

Configure Repositories Globally

← Older revision		Revision as of 23:20, 8 August 2025
Line 65:		Line 65:

	==== Configure Repositories Globally ====		==== 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" ];		wantedBy = [ "multi-user.target" ];
	path = [ pkgs.flatpak ];		path = [ pkgs.flatpak ];

Malix: /* Imperative */ enhancement: heading

2025-08-08T22:57:28Z

Imperative: enhancement: heading

← Older revision		Revision as of 22:57, 8 August 2025
Line 48:		Line 48:

	=== Imperative ===		=== 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		<syntaxhighlight lang="console">$ flatpak remote-add --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo
	$ flatpak update		$ flatpak update
Line 59:		Line 61:
	==== Graphical User Interface ====		==== 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?channel=unstable&show=gnome-software&type=packages <code>gnome-software</code> in nixpkgs])		To install Flatpaks graphically, you can use [https://apps.gnome.org/en-GB/Software/ the GNOME Software Application] ([https://search.nixos.org/packages?channel=unstable&show=gnome-software&type=packages <code>gnome-software</code> in nixpkgs])

			<small>'''Note''': installing Flatpaks through it is imperative</small>

	==== Configure Repositories Globally ====		==== Configure Repositories Globally ====

Malix: /* Per-User */ move GUI

2025-08-08T22:54:04Z

Per-User: move GUI

← Older revision		Revision as of 22:54, 8 August 2025
Line 9:		Line 9:
	{{file\|3=services.flatpak.enable = true;\|name=/etc/nixos/configuration.nix\|lang=nix}}		{{file\|3=services.flatpak.enable = true;\|name=/etc/nixos/configuration.nix\|lang=nix}}
	=== Per-User ===		=== 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" = {		{{file\|3=users.users."user" = {
	packages = with pkgs; [		packages = with pkgs; [
	flatpak		flatpak
	~~gnome-software~~
	];		];
	};\|name=/etc/nixos/configuration.nix\|lang=nix}}		};\|name=/etc/nixos/configuration.nix\|lang=nix}}
Line 57:		Line 56:
	$ flatpak install flathub com.github.tchx84.Flatseal		$ flatpak install flathub com.github.tchx84.Flatseal
	$ flatpak run com.github.tchx84.Flatseal</syntaxhighlight>		$ 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?channel=unstable&show=gnome-software&type=packages <code>gnome-software</code> in nixpkgs])

	==== Configure Repositories Globally ====		==== Configure Repositories Globally ====

Malix: /* nix-flatpak */ feat: external documentation link

2025-08-08T14:58:36Z

nix-flatpak: feat: external documentation link

← Older revision		Revision as of 14:58, 8 August 2025
Line 38:		Line 38:

	It supports flakes or [https://github.com/nix-community/home-manager home-manager], but doesn't support non-flakes only		It supports flakes or [https://github.com/nix-community/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] ====		==== [https://github.com/in-a-dil-emma/declarative-flatpak declarative-flatpak] ====