FLATPAK-REPAIR(1)

📦
version 1.18.4 · 15 versions
, in debian trixie, fedora 44, nixpkgs unstable, ubuntu stonking

💖 FLATPAK-REPAIR 💖

okay bestie, sit down, hydrate, because we're doing maintenance on your flatpak setup and honestly? it's giving spa day for your filesystem. this is flatpak-repair, section 1 of the manual, and it's the one you call when things are lowkey broken. 🧚

✨ NAME ✨

flatpak-repair — Repair a flatpak installation 💅

🌸 SYNOPSIS 🌸

flatpak repair [OPTION...]

🦋 DESCRIPTION 🦋

so like. Repair a flatpak installation by pruning and reinstalling invalid objects. that's the whole vibe. the repair command does all of the following, no skips, no shortcuts:

  • 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). 🔁
GIRLIE LISTEN. note that flatpak repair has to be run with root privileges to operate on the system installation. do not come crying to me when it says no. it will say no. 😭

An alternative command for repairing OSTree repositories is ostree fsck. different tool, same energy. 🫶

🎀 OPTIONS 🎀

The following options are understood:

  • -h, --help — Show help options and exit. the classic "what does anything do" button, we love her.
  • -u, --user — Repair per-user installation. just yours, just your little corner of the world. 🍓
  • --system — Repair system-wide installation. the big one, the main character energy one. 👑
  • --installation=NAME — Repair the system-wide installation specified by NAME among those defined in /etc/flatpak/installations.d/. Using --installation=default is equivalent to using --system. iykyk 💅
  • --dry-run — Only report inconsistencies, don't make any changes. look, don't touch. window shopping. 🛍️
  • --reinstall-all — Reinstall all refs, regardless of whether they were removed from the repo or not. no thoughts, just reinstall. 🔥
  • -v, --verbose — Print debug information during command processing. she's chatty and we respect it. 💬
  • --ostree-verbose — Print OSTree debug information during command processing. even more chatty. deep lore. 🌈

⭐ EXAMPLES ⭐

the system one, with the power of sudo:

$ sudo flatpak repair

the just-for-you one, no root required:

$ flatpak repair --user

💜 SEE ALSO 💜

flatpak(1), ostree-fsck(1)

okay that's the whole page!! this came to you from the flatpak source, page FLATPAK REPAIR(1) in the manual, and honestly there's no date on this footer bestie, it's simply timeless. go forth and repair, you're gonna slay. 🦋✨

📦 where this page comes from