The remote config file format is using the same .ini file format
that is used for systemd unit files or application .desktop
files.
[remote ...]
All the configuration for the the remote with name NAME is
contained in the [remote "NAME"] group.
The following keys are recognized by OSTree, among others:
url (string)
The url for the remote. An URL of the form oci+https:// or
oci+http:// is a Flatpak extension that indicates that the
remote is not an ostree repository, but is rather an URL to
an index of OCI images that are stored within a container
image registry.
gpg-verify (boolean)
Whether to use GPG verification for content from this remote.
gpg-verify-summary (boolean)
Whether to use GPG verification for the summary of this
remote.
This is ignored if collection-id is set, as refs are verified
in commit metadata in that case. Enabling gpg-verify-summary
would break peer to peer distribution of refs.
collection-id (string)
The globally unique identifier for the upstream collection
repository, to allow mirrors to be grouped.
All flatpak-specific keys have a xa. prefix:
xa.disable (boolean)
Whether the remote is disabled. Defaults to false.
xa.prio (integer)
The priority for the remote. This is used when listing
remotes, and when searching them for the runtime needed by an
app. The remote providing the app is searched for its runtime
before others with equal priority. Defaults to 1.
xa.noenumerate (boolean)
Whether this remote should be used when presenting available
apps/runtimes, or when searching for a runtime dependency.
Defaults to true.
xa.nodeps (boolean)
Whether this remote should be used when searching for
dependencies. Defaults to true.
xa.title (string)
An optional title to use when presenting this remote in a UI.
xa.title-is-set (boolean)
This key is set to true if xa.title has been explicitly set.
xa.comment (string)
An optional single-line comment to use when presenting this
remote in a UI.
xa.comment-is-set (boolean)
This key is set to true if xa.comment has been explicitly
set.
xa.description (string)
An optional full-paragraph of text to use when presenting
this remote in a UI.
xa.description-is-set (boolean)
This key is set to true if xa.description has been explicitly
set.
xa.homepage (string)
An optional URL that points to a website for this repository
to use when presenting this remote in a UI.
xa.homepage-is-set (boolean)
This key is set to true if xa.homepage has been explicitly
set.
xa.icon (string)
An optional URL that points to an icon for this repository to
use when presenting this remote in a UI.
xa.icon-is-set (boolean)
This key is set to true if xa.icon has been explicitly set.
xa.default-branch (string)
The default branch to use when installing from this remote.
xa.default-branch-is-set (boolean)
This key is set to true if xa.default-branch has been
explicitly set.
xa.main-ref (string)
The main reference served by this remote. This is used for
origin remotes of applications installed via a flatpakref
file.
