The Funtoo Linux project has transitioned to "Hobby Mode" and this wiki is now read-only.
Flatpak
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:
/etc/conf.d/modules modules="fuse"
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.
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
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
Then add the following line to /etc/portage/package.use:
etc/portage/package.use gnome-extra/gnome-software flatpak
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.