FLATPAK PREINSTALL(1)

    .SH "NAME" flatpak-preinstall - Install flatpaks that are part of the operating system
    .SH "SYNOPSIS"
            .HP u
                flatpak preinstall
                 [OPTION...]

    .SH "DESCRIPTION"

        .PP This command manages flatpaks that are part of the operating system. If no options are given, running flatpak preinstall will synchronize (install and remove) flatpaks to match the set that the OS vendor has chosen.
        .PP Preinstalled flatpaks are defined by dropping .preinstall files into the directories /usr/share/flatpak/preinstall.d/ and /etc/flatpak/preinstall.d/. The OS runs flatpak preinstall -y (or its GUI equivalent) on system startup, which then does the actual installation.
        .PP This system allows the OS vendor to define the list of flatpaks that are installed together with the OS, and also makes it possible for the OS vendor to make changes to the list in the future, which is then applied once flatpak preinstall is run next time. Users can opt out of preinstalled flatpaks by simply uninstalling them, at which point they won't get automatically reinstalled again.

    .SH "FILE FORMAT"

        .PP The .preinstall file is using the same .ini file format that is used for systemd unit files or application .desktop files.
        .SS "[Flatpak Preinstall NAME]"

            .PP The NAME is the fully qualified name of the runtime or application. All the information for a single runtime or application is contained in one [Flatpak Preinstall NAME] group. Multiple groups can be defined in a single file.
            .PP The following keys can be present in this group:

                .PP Install (boolean)

                        Whether this group should be installed. If this key is not specified, the group will be installed.
                    .RE
                    .PP Branch (string)

                            The name of the branch from which to install the application or runtime. If this key is not specified, the "master" branch is used.
                        .RE
                        .PP IsRuntime (boolean)

                                Whether this group refers to a runtime. If this key is not specified, the group is assumed to refer to an application.
                            .RE
                            .PP CollectionID (string)

                                    The collection ID of the remote to use, if it has one.
                                .RE

                    .SH "EXAMPLE"

                    [Flatpak Preinstall org.gnome.Loupe]
                    Branch=stable
                    IsRuntime=false

                    .SH "OPTIONS"

                        .PP The following options are understood:

                            .PP -h, --help

                                    Show help options and exit.
                                .RE
                                .PP --reinstall

                                        Uninstall first if already installed.
                                    .RE
                                    .PP -u, --user

                                            Install the application or runtime in a per-user installation.
                                        .RE
                                        .PP --system

                                                Install the application or runtime in the default system-wide installation.
                                            .RE
                                            .PP --installation=NAME

                                                    Install the application or runtime in a system-wide installation specified by NAME among those defined in /etc/flatpak/installations.d/. Using --installation=default is equivalent to using --system.
                                                .RE
                                                .PP --no-deploy

                                                        Download the latest version, but don't deploy it.
                                                    .RE
                                                    .PP --no-pull

                                                            Don't download the latest version, deploy whatever is locally available.
                                                        .RE
                                                        .PP --no-related

                                                                Don't download related extensions, such as the locale data.
                                                            .RE
                                                            .PP --no-deps

                                                                    Don't verify runtime dependencies when installing.
                                                                .RE
                                                                .PP --sideload-repo=PATH

                                                                        Adds an extra local ostree repo as a source for installation. This is equivalent to using the sideload-repos directories (see flatpak(1)), but can be done on a per-command basis. Any path added here is used in addition to ones in those directories.
                                                                    .RE
                                                                    .PP --include-sdk

                                                                            For each app being installed, also installs the SDK that was used to build it. Implies --or-update; incompatible with --no-deps.
                                                                        .RE
                                                                        .PP --include-debug

                                                                                For each ref being installed, as well as all dependencies, also installs its debug info. Implies --or-update; incompatible with --no-deps.
                                                                            .RE
                                                                            .PP -y, --assumeyes

                                                                                    Automatically answer yes to all questions (or pick the most prioritized answer). This is useful for automation.
                                                                                .RE
                                                                                .PP --noninteractive

                                                                                        Produce minimal output and avoid most questions. This is suitable for use in non-interactive situations, e.g. in a build script.
                                                                                    .RE
                                                                                    .PP -v, --verbose

                                                                                            Print debug information during command processing.
                                                                                        .RE
                                                                                        .PP --ostree-verbose

                                                                                                Print OSTree debug information during command processing.
                                                                                            .RE

                                                                                    .SH "EXAMPLES"

                                                                                        .PP $ flatpak preinstall

                                                                                    .SH "SEE ALSO"

                                                                                        .PP flatpak(1),