FLATPAK-REMOTE-MODIFY(1)

💖 FLATPAK-REMOTE-MODIFY — Modify a remote repository 💖

okay bestie, so you already have a remote repository in your flatpak setup and you wanna change stuff about it? that's literally what flatpak-remote-modify is for. it's the glow-up command for remotes. this page lives in the FLATPAK REMOTE-MODI(1) manual (yes the header says that, we don't question the header 💀).

---

✨ SYNOPSIS ✨

flatpak remote-modify [OPTION...] NAME

---

🌸 DESCRIPTION 🌸

so basically: this modifies the options for a remote repository that already exists in the flatpak repository configuration. NAME is the name of the remote you're messing with. no cap.

unless you override it with --system, --user, or --installation, this command picks either the default system-wide installation or the per-user one — whichever one has that REMOTE in it. it just figures it out. main character energy tbh.

---

👑 OPTIONS 👑

here's the whole menu, and yes we're going through all of it, i don't skip:

• -h, --help — shows the help options and dips. bye bestie 🫶
• -u, --user — modifies the per-user configuration.
• --system — modifies the default system-wide configuration.
• --installation=NAME — modifies a system-wide installation specified by NAME, out of the ones defined in /etc/flatpak/installations.d/. and psst — using --installation=default is the exact same thing as using --system.
• --no-gpg-verify — disables GPG verification for the added remote. (the vibe check is OFF 🔥)
• --gpg-verify — enables GPG verification for the added remote. (vibe check back ON ✨)
• --prio=PRIO — sets the priority for the remote. default is 1, and higher means more prioritized. this is mostly for graphical installation tools.
• --subset=SUBSET — limits the refs available from the remote to just the ones that are part of the named subset.
• --no-enumerate — marks the remote as not enumerated. that means the remote won't be used to list applications (like in graphical installation tools, yk). it also won't be used for runtime dependency resolution (same as --no-use-for-deps).
• --no-use-for-deps — marks the remote as not to be used for automatic runtime dependency resolution.
• --disable — disables the remote. disabled remotes will not be automatically updated from. it's giving ghosted 😭
• --enable — enables the remote.
• --enumerate — marks the remote as enumerated. that means the remote will be used to list applications, e.g. in graphical installation tools.
• --use-for-deps — marks the remote as to be used for automatic runtime dependency resolution.
• --title=TITLE — a title for the remote, e.g. for display in a UI.
• --comment=COMMENT — a single-line comment for the remote, e.g. for display in a UI.
• --description=DESCRIPTION — a full-paragraph description for the remote, e.g. for display in a UI.
• --homepage=URL — URL for a website for the remote, e.g. for display in a UI.
• --icon=URL — URL for an icon for the remote, e.g. for display in a UI.
• --default-branch=BRANCH — a default branch for the remote, mainly for use in a UI.
• --collection-id=COLLECTION-ID — the globally unique identifier of the remote repository, which lets mirrors get grouped together. ⚠️ this must only be set to the collection ID provided by the remote, and must not be set if the remote doesn't provide a collection ID. read that twice, bestie.
• --url=URL — sets a new URL.
• --update-metadata — updates the remote's extra metadata from the OSTree repository's summary file. rn only xa.title and xa.default-branch are supported. it's giving limited edition 💅
• --no-filter, --filter=FILE — modifies the path (or unsets it) for the local filter used for this remote. see flatpak-remote-add(1) for the deets on the filter file format.
• --gpg-import=FILE — imports gpg keys from the specified keyring file as trusted for the new remote. and if the file is -, the keyring is read from standard input. iconic.
• --signature-lookaside=URL — specifies a URL to be used to look up signatures for this remote (OCI remotes only).
• --authenticator-name=NAME — specifies the authenticator to use for the remote.
• --authenticator-option=KEY=VALUE — specifies an authenticator option for the remote.
• --authenticator-install — enables auto-installation of authenticator.
• --no-authenticator-install — disables auto-installation of authenticator.
• --follow-redirect — follows xa.redirect-url defined in the summary file.
• --no-follow-redirect — does not follow xa.redirect-url defined in the summary file.
• -v, --verbose — prints debug information during command processing.
• --ostree-verbose — prints OSTree debug information during command processing.

---

🦋 EXAMPLES 🦋

look, a real one, copy-paste ready:

$ flatpak --user remote-modify --no-gpg-verify test-repo

---

🌈 SEE ALSO 🌈

flatpak(1), flatpak-remote-add(1), flatpak-remote-delete(1), flatpak-remotes(1)

---

and that's the whole page, bestie 💜 this one comes to you straight from the flatpak source, page FLATPAK REMOTE-MODI(1) — go forth and modify those remotes, you've got this 🎀✨