From Funtoo
Revision as of 06:33, November 17, 2023 by Pnoecker (talk | contribs) (note that update shouldn't be run as sudo.)
Jump to navigation Jump to search

Flatpak is a container-based method of using software. Flatpak software once installed works on any Linux distribution as long as you have the Flatpak framework installed.

Prepping the Kernel

Run the following command to enable kernel to generate namespaces for non-root users.

root # echo 1 > /proc/sys/kernel/unprivileged_userns_clone
root # echo 'kernel.unprivileged_userns_clone=1' > /etc/sysctl.d/unprivileged_userns_clone.conf

You will also need to ensure that the fuse module is loaded by default. This does not happen automatically using the official debian-sources kernel. To do this, type:

root # modprobe fuse

To make this permanent, add the following line to /etc/conf.d/modules:


Installing Flatpak

You can now install Flatpak with the following command.

root # emerge -v sys-apps/flatpak

Setting up the Flathub Repos

To add the Flathub repo to Flatpak you just need to run the following command, an important note is most Flatpak commands DO NOT need root and can be run as a standard user. To run the commands as a standard user, supply the --user option. In several cases you MUST run commands as a user, such as update.

user $ flatpak remote-add --if-not-exists flathub https://flathub.org/repo/flathub.flatpakrepo --user

Installing Flatpak Software

For Funtoo most of the time you would install the Flatpak software through the terminal like so:

user $ flatpak install flathub com.valvesoftware.Steam
  • install steam udev rules:
root # wget https://raw.githubusercontent.com/ValveSoftware/steam-devices/master/60-steam-input.rules -O /etc/udev/rules.d/60-steam-input.rules
root # wget https://raw.githubusercontent.com/ValveSoftware/steam-devices/master/60-steam-vr.rules -O /etc/udev/rules.d/60-steam-vr.rules
root # udevadm control --reload-rules
root # udevadm trigger

All of the software from the Flathub repo has the terminal commands listed on their individual pages on the Flatpak website. If you install gnome-extra/gnome-software you can have a graphical interface for installing the software locally.

root # emerge -av gnome-extra/gnome-software

Updating Flatpak Software

While Flatpak does a good job of installing the latest version of required packages when you manually install them, existing package updates must be triggered manually.

user $ flatpak update

Important Notes for Nvidia Driver Users

During the installation of applications like Steam through the terminal after first install of Flatpak, Flatpak should detect that you are using the Nvidia drivers and have you select the correct one for it to use from the list. Make sure you select the driver that matches your system's driver. This has not been tested if you are installing software for the first time with gnome-software.