flatpak-repair(1) — Linux manual page


FLATPAK REPAIR(1)            flatpak repair            FLATPAK REPAIR(1)

NAME         top

       flatpak-repair - Repair a flatpak installation

SYNOPSIS         top

       flatpak repair [OPTION...]

DESCRIPTION         top

       Repair a flatpak installation by pruning and reinstalling invalid
       objects. The repair command does all of the following:

       •   Scan all locally available refs, removing any that don't
           correspond to a deployed ref.

       •   Verify each commit they point to, removing any invalid
           objects and noting any missing objects.

       •   Remove any refs that had an invalid object, and any
           non-partial refs that had missing objects.

       •   Prune all objects not referenced by a ref, which gets rid of
           any possibly invalid non-scanned objects.

       •   Enumerate all deployed refs and re-install any that are not
           in the repo (or are partial for a non-subdir deploy).

       Note that flatpak repair has to be run with root privileges to
       operate on the system installation.

       An alternative command for repairing OSTree repositories is
       ostree fsck.

OPTIONS         top

       The following options are understood:

       -h, --help
           Show help options and exit.

       -u, --user
           Repair per-user installation.

           Repair system-wide installation.

           Repair the system-wide installation specified by NAME among
           those defined in /etc/flatpak/installations.d/. Using
           --installation=default is equivalent to using --system.

           Only report inconsistencies, don't make any changes

           Reinstall all refs, regardless of whether they were removed
           from the repo or not

       -v, --verbose
           Print debug information during command processing.

           Print OSTree debug information during command processing.

EXAMPLES         top

       $ sudo flatpak repair

       $ flatpak repair --user

SEE ALSO         top

       flatpak(1), ostree-fsck(1)

COLOPHON         top

       This page is part of the flatpak (a tool for building and
       distributing desktop applications on Linux) project.  Information
       about the project can be found at ⟨http://flatpak.org/⟩.  It is
       not known how to report bugs for this man page; if you know,
       please send a mail to man-pages@man7.org.  This page was obtained
       from the project's upstream Git repository
       ⟨https://github.com/flatpak/flatpak⟩ on 2023-12-22.  (At that
       time, the date of the most recent commit that was found in the
       repository was 2023-12-08.)  If you discover any rendering
       problems in this HTML version of the page, or you believe there
       is a better or more up-to-date source for the page, or you have
       corrections or improvements to the information in this COLOPHON
       (which is not part of the original manual page), send a mail to

flatpak                                                FLATPAK REPAIR(1)

Pages that refer to this page: flatpak(1)