Flatpak - Revision history

H8d13 at 14:27, 6 December 2025

2025-12-06T14:27:38Z

← Older revision		Revision as of 14:27, 6 December 2025
Line 183:		Line 183:

	Ensure that [[#Portals\|portals]] are installed and started.		Ensure that [[#Portals\|portals]] are installed and started.

			=== SSL Certificates errors Electron ===

			Bellow error occurs when running specific runtimes. Especially Electron dependent apps (a good reason to use Flatpak in the first place).

			<pre>
			ERROR:ssl_client_socket_impl.cc(960) handshake failed; returned -1, SSL error code 1, net_error -202
			</pre>

			Fixed using:

			{{Cmd\|<nowiki>$ doas apk add p11-kit-trust p11-kit-server nss-tools
			$ doas update-ca-certificates</nowiki>}}

	== See also ==		== See also ==

Prabuanand: fixed typo

2025-10-14T10:58:52Z

fixed typo

← Older revision		Revision as of 10:58, 14 October 2025
Line 6:		Line 6:
	* Enable [[D-Bus]], specifically [[D-Bus#D-Bus session\|D-Bus session]] needs to be started separately for each user.		* Enable [[D-Bus]], specifically [[D-Bus#D-Bus session\|D-Bus session]] needs to be started separately for each user.
	* Enable [[Polkit]].		* Enable [[Polkit]].
	* Ensure that [[#Portals\|~~portals~~]] are installed and running.		* Ensure that [[#Portals\|portal]] packages are installed and running.

	== Installation ==		== Installation ==

Prabuanand: added test command

2025-10-14T07:56:17Z

added test command

← Older revision		Revision as of 07:56, 14 October 2025
Line 125:		Line 125:

	Once installed, [[Desktop_environments_and_Window_managers#Desktop_environments\|Desktop Environment]] autostart these portals. However, minimal desktops like [[Sway#Flatpaks\|Sway]] require configuration to start the portals and may even require multiple backends.		Once installed, [[Desktop_environments_and_Window_managers#Desktop_environments\|Desktop Environment]] autostart these portals. However, minimal desktops like [[Sway#Flatpaks\|Sway]] require configuration to start the portals and may even require multiple backends.

			To test, if portals are properly configured, issue the command:{{Cmd\|<nowiki>$ dbus-send --session --print-reply --dest=org.freedesktop.portal.Desktop /org/freedesktop/portal/desktoporg.freedesktop.portal.Desktop.GetApplications</nowiki>}}

			The output "Error org.freedesktop.DBus.Error.ServiceUnknown: The name org.freedesktop.portal.Desktop was not provided by any .service files" for the above command indicates that portals are not configured properly.

	== Troubleshooting ==		== Troubleshooting ==

Prabuanand: moved error message to troubleshooting section

2025-10-14T06:50:23Z

moved error message to troubleshooting section

← Older revision		Revision as of 06:50, 14 October 2025
Line 125:		Line 125:

	Once installed, [[Desktop_environments_and_Window_managers#Desktop_environments\|Desktop Environment]] autostart these portals. However, minimal desktops like [[Sway#Flatpaks\|Sway]] require configuration to start the portals and may even require multiple backends.		Once installed, [[Desktop_environments_and_Window_managers#Desktop_environments\|Desktop Environment]] autostart these portals. However, minimal desktops like [[Sway#Flatpaks\|Sway]] require configuration to start the portals and may even require multiple backends.

	~~''GDBus'' errors occur, if your flatpak application fails to interface with the portal. This can cause issues such as with opening your file directories from a flatpak application.~~

	== Troubleshooting ==		== Troubleshooting ==
Line 171:		Line 169:

	There is a current issue where sometimes flatpak will try to read the system-wide repository even if your install is with --user. This will result in failure to launch a flatpak application with the terminal reading ""error: While opening repository /var/lib/flatpak/repo: opening repo: opendir(/var/lib/flatpak/repo): No such file or directory". An alpine user has posted more information, as well as a workaround, at https://github.com/flatpak/flatpak/issues/5488		There is a current issue where sometimes flatpak will try to read the system-wide repository even if your install is with --user. This will result in failure to launch a flatpak application with the terminal reading ""error: While opening repository /var/lib/flatpak/repo: opening repo: opendir(/var/lib/flatpak/repo): No such file or directory". An alpine user has posted more information, as well as a workaround, at https://github.com/flatpak/flatpak/issues/5488

			=== GDBus Error ===

			Below errors occur, if your flatpak application fails to interface with the portal. This can cause issues such as with opening your file directories from a flatpak application.

			<pre>
			(firefox:12345): Gtk-WARNING : 12:00:00.000: Unable to load an interface for org.freedesktop.portal.FileChooser: GDBus.Error:org.freedesktop.DBus.Error.ServiceUnknown: The name org.freedesktop.portal.Desktop** was not provided by any .service files
			</pre>

			Ensure that [[#Portals\|portals]] are installed and started.

	== See also ==		== See also ==

Prabuanand: moved content from Sway page

2025-10-14T05:58:16Z

moved content from Sway page

← Older revision		Revision as of 05:58, 14 October 2025
Line 6:		Line 6:
	* Enable [[D-Bus]], specifically [[D-Bus#D-Bus session\|D-Bus session]] needs to be started separately for each user.		* Enable [[D-Bus]], specifically [[D-Bus#D-Bus session\|D-Bus session]] needs to be started separately for each user.
	* Enable [[Polkit]].		* Enable [[Polkit]].
	* ~~Install {{Pkg~~\|~~xdg-desktop-portal}} package along with an implementation of {{ic\|xdg-desktop-portal}}, e.g. {{Pkg\|xdg-desktop-portal-gtk}} package~~.		* Ensure that [[#Portals\|portals]] are installed and running.

	== Installation ==		== Installation ==
Line 119:		Line 119:
	Which do you want to use (0 to abort)? [0-3]:		Which do you want to use (0 to abort)? [0-3]:
	</p>		</p>

			== Portals ==

			Due to their sandboxing, flatpaks require the use of [https://docs.flatpak.org/en/latest/desktop-integration.html#portals portal]. The portal frontend service for Flatpak i.e [https://flatpak.github.io/xdg-desktop-portal/ XDG Desktop Portal] relies on backends provided by the toolkits. So ensure that {{Pkg\|xdg-desktop-portal}} package along with the appropriate backend package from the list of {{pkg\|xdg-desktop-portal-*}} packages is installed.

			Once installed, [[Desktop_environments_and_Window_managers#Desktop_environments\|Desktop Environment]] autostart these portals. However, minimal desktops like [[Sway#Flatpaks\|Sway]] require configuration to start the portals and may even require multiple backends.

			''GDBus'' errors occur, if your flatpak application fails to interface with the portal. This can cause issues such as with opening your file directories from a flatpak application.

	== Troubleshooting ==		== Troubleshooting ==

	~~{{Draft\|More documentation and testing is needed, but everything currently here should be safe to follow.}}~~

	=== Permission errors ===		=== Permission errors ===

Prabuanand: removed :Category:Desktop as per Help_talk:Style

2025-05-25T15:22:20Z

removed Category:Desktop as per Help_talk:Style

← Older revision		Revision as of 15:22, 25 May 2025
Line 167:		Line 167:

	== See also ==		== See also ==

	* [https://flatpak.org/setup/Alpine/ Official setup Guide]		* [https://flatpak.org/setup/Alpine/ Official setup Guide]
	* [https://docs.flatpak.org/en/latest/available-runtimes.html Flatpak - available runtimes]		* [https://docs.flatpak.org/en/latest/available-runtimes.html Flatpak - available runtimes]
Line 174:		Line 175:

	[[Category:Package Manager]]		[[Category:Package Manager]]
	~~[[Category: Desktop]]~~

Prabuanand: fixed typo and moved the note

2025-05-25T09:12:19Z

fixed typo and moved the note

← Older revision		Revision as of 09:12, 25 May 2025
Line 10:		Line 10:
	== Installation ==		== Installation ==

	Following ~~Installation~~ instructions are based on ~~from~~ [https://flathub.org/setup/Alpine official Flatpak guide] with additional customisations ~~related to:~~		Following instructions are based on [https://flathub.org/setup/Alpine official Flatpak guide] with additional customisations.

	=== Install Flatpak ===		=== Install Flatpak ===
Line 32:		Line 32:
	== Flatpak usage ==		== Flatpak usage ==

	~~A number of questions regarding what permissions the flatpak app requires and what runtimes or other software it needs will be asked before installing the same.~~ To get all of the available options to use with the '''flatpak''' command run: '''flatpak --help''' or '''flatpak -h'''		To get all of the available options to use with the '''flatpak''' command run: '''flatpak --help''' or '''flatpak -h'''

	=== Search for flatpak apps ===		=== Search for flatpak apps ===
Line 49:		Line 49:

	=== Install flatpak apps ===		=== Install flatpak apps ===

			When installing a flatpak app, a number of questions regarding what permissions the app requires and what runtimes or other software it needs will be asked.

	To install a package run '''flatpak --user install <applicationname>'''		To install a package run '''flatpak --user install <applicationname>'''

Prabuanand: moved note

2025-05-25T06:17:49Z

moved note

← Older revision		Revision as of 06:17, 25 May 2025
Line 32:		Line 32:
	== Flatpak usage ==		== Flatpak usage ==

	To get all of the available options to use with the '''flatpak''' command run: '''flatpak --help''' or '''flatpak -h'''		A number of questions regarding what permissions the flatpak app requires and what runtimes or other software it needs will be asked before installing the same. To get all of the available options to use with the '''flatpak''' command run: '''flatpak --help''' or '''flatpak -h'''

	=== Search for flatpak apps ===		=== Search for flatpak apps ===
Line 49:		Line 49:

	=== Install flatpak apps ===		=== Install flatpak apps ===

	~~A number of questions regarding what permissions the flatpak app requires and what runtimes or other software it needs will be asked before installing the same.~~

	To install a package run '''flatpak --user install <applicationname>'''		To install a package run '''flatpak --user install <applicationname>'''

Prabuanand: based on note from Saijin_Naib on 2025-05-25 02:57:39 in irc channel #alpine-linux

2025-05-25T05:50:54Z

based on note from Saijin_Naib on 2025-05-25 02:57:39 in irc channel #alpine-linux

← Older revision		Revision as of 05:50, 25 May 2025
Line 49:		Line 49:

	=== Install flatpak apps ===		=== Install flatpak apps ===

			A number of questions regarding what permissions the flatpak app requires and what runtimes or other software it needs will be asked before installing the same.

	To install a package run '''flatpak --user install <applicationname>'''		To install a package run '''flatpak --user install <applicationname>'''

Prabuanand: Removed the instruction to restart the system based on discussion page note by zcaryfish

2025-05-10T16:09:54Z

Removed the instruction to restart the system based on discussion page note by zcaryfish

← Older revision		Revision as of 16:09, 10 May 2025
Line 26:		Line 26:
	Next you need to add a repository, for this guide we will use the recommended repository, [https://flathub.org Flathub]. {{cmd\|$ flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo}}		Next you need to add a repository, for this guide we will use the recommended repository, [https://flathub.org Flathub]. {{cmd\|$ flatpak remote-add --user --if-not-exists flathub https://dl.flathub.org/repo/flathub.flatpakrepo}}

	Flatpak is now ready to use immediately, however flatpak desktop entries will not appear until you restart your desktop session ~~(i.e.~~ by logging out and then logging back in~~). To complete the setup, restart your system~~. Now all you have to do is install apps!		Flatpak is now ready to use immediately, however flatpak desktop entries will not appear until you restart your desktop session by logging out and then logging back in.

			Now all you have to do is install apps!

	== Flatpak usage ==		== Flatpak usage ==