FLATPAK-BUILD-UPDATE-REPO(1)

💖 flatpak-build-update-repo — the manual page, but make it cute 💖

okay bestie, so this is the page for flatpak-build-update-repo, straight outta the flatpak manual. it lives in section 1. let's get into it ✨

---

🎀 NAME 🎀

flatpak-build-update-repo — create a repository from a build directory

like, literally that's the whole job. no notes. 💅

---

✨ SYNOPSIS ✨

flatpak build-update-repo [OPTION...] LOCATION

---

🦋 DESCRIPTION 🦋

so what this does is it updates the repository metadata for the repo sitting at LOCATION. and when it does that, it generates an OSTree summary file that lists out everything inside the repository. that summary is the whole moment — it's what flatpak remote-ls and the other commands use to show you what's in remote repositories. like, without it, nothing can see anything. it's giving backstage pass. 🎟️

and after you run this? LOCATION can be used as the repository location for flatpak remote-add. either by exporting it over http, or just directly with a file: url. easy. 🫶

---

🌸 OPTIONS 🌸

here's everything it understands, bestie. all of it. no skips:

• -h, --help — shows the help options and dips. bye 👋
• --redirect-url=URL — redirects this repo to a brand new URL. glow-up relocation.
• --title=TITLE — a title for the repository, like for showing off in a UI. the title gets stored in the repository summary. put it in the summary, it stays in the summary. 💾
• --comment=COMMENT — a single-line comment for the remote, again for UI display purposes. stored in the repository summary too.
• --description=DESCRIPTION — a full-paragraph description for the remote, e.g. for display in a UI. yep, stored in the repository summary. it's the long-form version of the comment, main character energy.
• --homepage=URL — URL for a website for the remote, e.g. for display in a UI. the url is stored in the repository summary.
• --icon=URL — URL for an icon for the remote, e.g. for display in a UI. url goes in the repository summary, obviously. ✨
• --default-branch=BRANCH — a default branch for the repository, mainly for use in a UI.
• --gpg-import=FILE — imports a new default GPG public key from the file you give it. 🔑
• --collection-id=COLLECTION-ID — the globally unique identifier of the remote repository, so mirrors can get grouped together. > ⚠️ this must be set to a globally unique reverse DNS string if the repository is gonna be made publicly available. if a collection ID is already set on an existing repository, this will update it. if you don't specify it, the existing collection ID is left unchanged. no cap.
• --deploy-collection-id — deploys the collection ID (the one you set with --collection-id) into the static remote configuration for all clients. > 🚨 this is irrevocable once it's published in a repository. like, once it's out, it's out. use it to decide when to roll out a collection ID to users of an existing repository. and if you're constructing a brand new repository that has a collection ID, you should typically always pass this option. periodt.
• --deploy-sideload-collection-id — basically the same vibe as --deploy-collection-id, except it only applies the deploy to clients newer than flatpak 1.7, which is the version that supports the new form of sideloads. 🧚
• --gpg-sign=KEYID — signs the commit with this GPG key. you can use this option multiple times, so go off. ✍️
• --gpg-homedir=PATH — the GPG Homedir to use when it's looking for keyrings.
• --generate-static-deltas — generates static deltas for all references. it makes from-empty and delta static files that let downloads go faster. speed. 🏃♀️
• --static-delta-jobs=NUM-JOBS — limits how many parallel jobs are creating static deltas. the default is the number of cpus. multitasking queen.
• --static-delta-ignore-ref=PATTERN — don't generate deltas for runtime or application id matching this pattern. for instance, --static-delta-ignore-ref=*.Sources means there will not be any deltas for source refs. leaving them on read. 🙈
• --prune — removes unreferenced objects in the repo. cleanup szn 🧹
• --prune-depth — only keeps at most this number of old versions for any particular ref. default is -1, which means infinite. hoarder mode enabled by default, wild.
• -v, --verbose — prints debug information during command processing. talk to meee.
• --ostree-verbose — prints OSTree debug information during command processing. even more talking.

---

👑 SEE ALSO 👑

ostree(1), flatpak(1), flatpak-remote-ls(1), flatpak-build-export(1)

---

and that's the whole page bestie!! this little masterpiece comes to you from the flatpak manual, FLATPAK BUILD-UPDAT(1) — yes the header really does truncate like that, it's iconic, we don't fix it. go update a repo. slay. 💅💖🦋