1FLATPAKREPO(5)                    flatpakrepo                   FLATPAKREPO(5)
2
3
4

NAME

6       flatpak-flatpakrepo - Reference to a remote
7

DESCRIPTION

9       Flatpak uses flatpakrepo files to share information about remotes. The
10       flatpakrepo file contains enough information to add the remote. Use the
11       flatpak remote-add --from command to do so.
12
13       flatpakrepo files may also contain additional information that is
14       useful when displaying a remote to the user, e.g. in an app store.
15
16       The filename extension commonly used for flatpakrepo files is
17       .flatpakrepo.
18

FILE FORMAT

20       The flatpakrepo file is using the same .ini file format that is used
21       for systemd unit files or application .desktop files.
22
23   [Flatpak Repo]
24       All the information is contained in the [Flatpak Repo] group.
25
26       The following keys can be present in this group:
27
28       Version (uint64)
29           The version of the file format, must be 1 if present.
30
31       Url (string)
32           The url for the remote. This key is mandatory.
33
34       GPGKey (string)
35           The base64-encoded gpg key for the remote.
36
37       DefaultBranch (string)
38           The default branch to use for this remote.
39
40       Subset (string)
41           Limit the remote to the named subset of refs.
42
43       Title (string)
44           The title of the remote. This should be a user-friendly name that
45           can be displayed e.g. in an app store.
46
47       Comment (string)
48           A short summary of the remote, for display e.g. in an app store.
49
50       Description (string)
51           A longer description of the remote, for display e.g. in an app
52           store.
53
54       Icon (string)
55           The url for an icon that can be used to represent the remote.
56
57       Homepage (string)
58           The url of a webpage describing the remote.
59
60       Filter (string)
61           The path of a local file to use to filter remote refs. See flatpak-
62           remote-add(1) for details on the format of the file.
63
64           Note: This field is treated a bit special by flatpak remote-add. If
65           you install a remote with --if-not-exists then and the remote is
66           already configured, then the filter field of the remote
67           configuration will be update anyway. And, if the filter field is
68           *not* specified then any existing filters are cleared. The goal
69           here is to allow a pre-configured filtered remote to be replaced
70           with the regular one if you add the normal upstream (unfiltered)
71           flatpakrepo file.
72
73       DeployCollectionID (string)
74           The collection ID of the remote, if it has one. This uniquely
75           identifies the collection of apps in the remote, to allow peer to
76           peer redistribution. It is recommended to use this key over
77           CollectionID because only newer clients pay attention to it (and
78           older clients don't handle collection IDs properly).
79
80       CollectionID (string)
81           This is deprecated but still supported for backwards compatibility.
82           Use DeployCollectionID instead.
83

EXAMPLE

85           [Flatpak Repo]
86           Title=gedit
87           Url=http://sdk.gnome.org/repo-apps/
88           GPGKey=mQENBFUUCGcBCAC/K9WeV4xCaKr3NKRqPXeY5mpaXAJyasLqCtrDx92WUgbu0voWrhohNAKpqizod2dvzc/XTxm3rHyIxmNfdhz1gaGhynU75Qw4aJVcly2eghTIl++gfDtOvrOZo/VuAq30f32dMIgHQdRwEpgCwz7WyjpqZYltPAEcCNL4MTChAfiHJeeiQ5ibystNBW8W6Ymf7sO4m4g5+/aOxI54oCOzD9TwBAe+yXcJJWtc2rAhMCjtyPJzxd0ZVXqIzCe1xRvJ6Rq7YCiMbiM2DQFWXKnmYQbj4TGNMnwNdAajCdrcBWEMSbzq7EzuThIJRd8Ky4BkEe1St6tuqwFaMZz+F9eXABEBAAG0KEdub21lIFNESyAzLjE2IDxnbm9tZS1vcy1saXN0QGdub21lLm9yZz6JATgEEwECACIFAlUUCGcCGwMGCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEArkz6VV0VKBa5cH/0vXa31YgEjNk78gGFXqnQxdD1WYA87OYxDi189l4lA802EFTF4wCBuZyDOqdd5BhS3Ab0cR778DmZXRUP2gwe+1zTJypU2JMnDpkwJ4NK1VP6/tE4SAPrznBtmb76BKaWBqUfZ9Wq1zg3ugvqkZB/Exq+usypIOwQVp1KL58TrjBRda0HvRctzkNhr0qYAtkfLFe0GvksBp4vBm8uGwAx7fw/HbhIjQ9pekTwvB+5GwDPO/tSip/1bQfCS+XJB8Ffa04HYPLGedalnWBrwhYY+G/kn5Zh9L/AC8xeLwTJTHM212rBjPa9CWs9C6a57MSaeGIEHLC1hEyiJJ15w8jmY=
89           DeployCollectionID=org.gnome.Apps
90

SEE ALSO

92       flatpak(1), flatpak-remote-add(1), flatpak-flatpakref(5)
93
94
95
96flatpak                                                         FLATPAKREPO(5)
Impressum