FlatFree — Setup Guide

Prerequisites

Before adding FlatFree, you need to have Flatpak installed on your system. Most distributions include it by default, but if not, you can install it using your package manager.

Add the FlatFree Remote

The following command adds the FlatFree repository to your Flatpak installation. Run this once, and you'll be able to install any FlatFree application.

flatpak remote-add --if-not-exists flatfree https://natalie.acreetionos.org/FlatFree/flatfree.flatpakrepo

Distribution Guides

Fedora

Flatpak comes pre-installed on Fedora. Just add the remote:

flatpak remote-add --if-not-exists flatfree https://natalie.acreetionos.org/FlatFree/flatfree.flatpakrepo

Ubuntu / Debian

Install Flatpak if not present, then add the remote:

sudo apt install flatpak
flatpak remote-add --if-not-exists flatfree https://natalie.acreetionos.org/FlatFree/flatfree.flatpakrepo

Arch Linux

Install Flatpak from the official repos, then add the remote:

sudo pacman -S flatpak
flatpak remote-add --if-not-exists flatfree https://natalie.acreetionos.org/FlatFree/flatfree.flatpakrepo

openSUSE

Install Flatpak if needed, then add the remote:

sudo zypper install flatpak
flatpak remote-add --if-not-exists flatfree https://natalie.acreetionos.org/FlatFree/flatfree.flatpakrepo

NixOS

With Flatpak enabled in your configuration, add the remote:

flatpak remote-add --if-not-exists flatfree https://natalie.acreetionos.org/FlatFree/flatfree.flatpakrepo

Solus

Flatpak is pre-installed on Solus. Add the remote:

flatpak remote-add --if-not-exists flatfree https://natalie.acreetionos.org/FlatFree/flatfree.flatpakrepo

Install an Application

Once the remote is added, installing an application is straightforward:

flatpak install flatfree org.acreetionos.MediaWriter

To run the application:

flatpak run org.acreetionos.MediaWriter

To update all installed FlatFree applications:

flatpak update

Verify the Remote

You can verify that the FlatFree remote is properly configured:

flatpak remotes

This should list flatfree among your configured remotes.

Troubleshooting

Certificate issues? Ensure your system's CA certificates are up to date. On most distributions, this is handled automatically by your package manager.

Remote not found? Double-check that you've copied the full URL correctly. The remote URL is case-sensitive.

Permission denied? The flatpak remote-add command typically does not require root privileges, but if you encounter permission issues, try with sudo.