1FLATPAK REMOTE(5)               flatpak remote               FLATPAK REMOTE(5)
2
3
4

NAME

6       flatpak-remote - Configuration for a remote
7

DESCRIPTION

9       Flatpak stores information about configured remotes for an installation
10       location in $installation/repo/config. For example, the remotes for the
11       default system-wide installation are in
12       $prefix/var/lib/flatpak/repo/config, and the remotes for the per-user
13       installation are in $HOME/.local/share/flatpak/repo/config.
14
15       Normally, it is not necessary to edit remote config files directly, the
16       flatpak remote-modify command should be used to change properties of
17       remotes.
18
19       System-wide remotes can be statically preconfigured by dropping
20       flatpakref files into /etc/flatpak/remotes.d/.
21

FILE FORMAT

23       The remote config file format is using the same .ini file format that
24       is used for systemd unit files or application .desktop files.
25
26   [remote ...]
27       All the configuration for the the remote with name NAME is contained in
28       the [remote "NAME"] group.
29
30       The following keys are recognized by OSTree, among others:
31
32       url (string)
33           The url for the remote. An URL of the form oci+https:// or
34           oci+http:// is a Flatpak extension that indicates that the remote
35           is not an ostree repository, but is rather an URL to an index of
36           OCI images that are stored within a container image registry.
37
38       gpg-verify (boolean)
39           Whether to use GPG verification for content from this remote.
40
41       gpg-verify-summary (boolean)
42           Whether to use GPG verification for the summary of this remote.
43
44           This is ignored if collection-id is set, as refs are verified in
45           commit metadata in that case. Enabling gpg-verify-summary would
46           break peer to peer distribution of refs.
47
48       collection-id (string)
49           The globally unique identifier for the upstream collection
50           repository, to allow mirrors to be grouped.
51
52       All flatpak-specific keys have a xa. prefix:
53
54       xa.disable (boolean)
55           Whether the remote is disabled. Defaults to false.
56
57       xa.prio (integer)
58           The priority for the remote. This is used when listing remotes.
59           Defaults to 1.
60
61       xa.noenumerate (boolean)
62           Whether this remote should be used when presenting available
63           contents. Defaults to true.
64
65       xa.nodeps (boolean)
66           Whether this remote should be used when searching for dependencies.
67           Defaults to true.
68
69       xa.title (string)
70           An optional title to use when presenting this remote in a UI.
71
72       xa.title-is-set (boolean)
73           This key is set to true if xa.title has been explicitly set.
74
75       xa.comment (string)
76           An optional single-line comment to use when presenting this remote
77           in a UI.
78
79       xa.comment-is-set (boolean)
80           This key is set to true if xa.comment has been explicitly set.
81
82       xa.description (string)
83           An optional full-paragraph of text to use when presenting this
84           remote in a UI.
85
86       xa.description-is-set (boolean)
87           This key is set to true if xa.description has been explicitly set.
88
89       xa.homepage (string)
90           An optional URL that points to a website for this repository to use
91           when presenting this remote in a UI.
92
93       xa.homepage-is-set (boolean)
94           This key is set to true if xa.homepage has been explicitly set.
95
96       xa.icon (string)
97           An optional URL that points to an icon for this repository to use
98           when presenting this remote in a UI.
99
100       xa.icon-is-set (boolean)
101           This key is set to true if xa.icon has been explicitly set.
102
103       xa.default-branch (string)
104           The default branch to use when installing from this remote.
105
106       xa.default-branch-is-set (boolean)
107           This key is set to true if xa.default-branch has been explicitly
108           set.
109
110       xa.main-ref (string)
111           The main reference served by this remote. This is used for origin
112           remotes of applications installed via a flatpakref file.
113

EXAMPLES

115           [remote "gnome-nightly-apps"]
116           gpg-verify=true
117           gpg-verify-summary=true
118           url=https://sdk.gnome.org/nightly/repo-apps/
119           xa.title=GNOME Applications
120
121           [remote "flathub"]
122           gpg-verify=true
123           gpg-verify-summary=false
124           collection-id=org.flathub.Stable
125           url=https://dl.flathub.org/repo/
126           xa.title=Flathub
127

SEE ALSO

129       flatpak-remote-modify(1)
130
131
132
133flatpak                                                      FLATPAK REMOTE(5)
Impressum