'\" t
.\"     Title: flatpakrepo
.\"    Author: Alexander Larsson <alexl@redhat.com>
.\" Generator: DocBook XSL Stylesheets v1.79.1 <http://docbook.sf.net/>
.\"      Date: 04/14/2021
.\"    Manual: flatpakrepo
.\"    Source: flatpak
.\"  Language: English
.\"
.TH "FLATPAKREPO" "5" "" "flatpak" "flatpakrepo"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
flatpak-flatpakrepo \- Reference to a remote
.SH "DESCRIPTION"
.PP
Flatpak uses flatpakrepo files to share information about remotes\&. The
flatpakrepo
file contains enough information to add the remote\&. Use the
\fBflatpak remote\-add \-\-from\fR
command to do so\&.
.PP
flatpakrepo files may also contain additional information that is useful when displaying a remote to the user, e\&.g\&. in an app store\&.
.PP
The filename extension commonly used for flatpakrepo files is
\&.flatpakrepo\&.
.SH "FILE FORMAT"
.PP
The flatpakrepo file is using the same \&.ini file format that is used for systemd unit files or application \&.desktop files\&.
.SS "[Flatpak Repo]"
.PP
All the information is contained in the [Flatpak Repo] group\&.
.PP
The following keys can be present in this group:
.PP
\fBVersion\fR (uint64)
.RS 4
The version of the file format, must be 1 if present\&.
.RE
.PP
\fBUrl\fR (string)
.RS 4
The url for the remote\&. This key is mandatory\&.
.RE
.PP
\fBGPGKey\fR (string)
.RS 4
The base64\-encoded gpg key for the remote\&.
.RE
.PP
\fBDefaultBranch\fR (string)
.RS 4
The default branch to use for this remote\&.
.RE
.PP
\fBSubset\fR (string)
.RS 4
Limit the remote to the named subset of refs\&.
.RE
.PP
\fBTitle\fR (string)
.RS 4
The title of the remote\&. This should be a user\-friendly name that can be displayed e\&.g\&. in an app store\&.
.RE
.PP
\fBComment\fR (string)
.RS 4
A short summary of the remote, for display e\&.g\&. in an app store\&.
.RE
.PP
\fBDescription\fR (string)
.RS 4
A longer description of the remote, for display e\&.g\&. in an app store\&.\&.
.RE
.PP
\fBIcon\fR (string)
.RS 4
The url for an icon that can be used to represent the remote\&.
.RE
.PP
\fBHomepage\fR (string)
.RS 4
The url of a webpage describing the remote\&.
.RE
.PP
\fBFilter\fR (string)
.RS 4
The path of a local file to use to filter remote refs\&. See
\fBflatpak-remote-add\fR(1)
for details on the format of the file\&.
.sp
Note: This field is treated a bit special by flatpak remote\-add\&. If you install a remote with \-\-if\-not\-exists then and the remote is already configured, then the filter field of the remote configuration will be update anyway\&. And, if the filter field is *not* specified then any existing filters are cleared\&. The goal here is to allow a pre\-configured filtered remote to be replaced with the regular one if you add the normal upstream (unfiltered) flatpakrepo file\&.
.RE
.PP
\fBDeployCollectionID\fR (string)
.RS 4
The collection ID of the remote, if it has one\&. This uniquely identifies the collection of apps in the remote, to allow peer to peer redistribution\&. It is recommended to use this key over CollectionID because only newer clients pay attention to it (and older clients don\*(Aqt handle collection IDs properly)\&.
.RE
.PP
\fBCollectionID\fR (string)
.RS 4
This is deprecated but still supported for backwards compatibility\&. Use DeployCollectionID instead\&.
.RE
.SH "EXAMPLE"
.sp
.if n \{\
.RS 4
.\}
.nf
[Flatpak Repo]
Title=gedit
Url=http://sdk\&.gnome\&.org/repo\-apps/
GPGKey=mQENBFUUCGcBCAC/K9WeV4xCaKr3NKRqPXeY5mpaXAJyasLqCtrDx92WUgbu0voWrhohNAKpqizod2dvzc/XTxm3rHyIxmNfdhz1gaGhynU75Qw4aJVcly2eghTIl++gfDtOvrOZo/VuAq30f32dMIgHQdRwEpgCwz7WyjpqZYltPAEcCNL4MTChAfiHJeeiQ5ibystNBW8W6Ymf7sO4m4g5+/aOxI54oCOzD9TwBAe+yXcJJWtc2rAhMCjtyPJzxd0ZVXqIzCe1xRvJ6Rq7YCiMbiM2DQFWXKnmYQbj4TGNMnwNdAajCdrcBWEMSbzq7EzuThIJRd8Ky4BkEe1St6tuqwFaMZz+F9eXABEBAAG0KEdub21lIFNESyAzLjE2IDxnbm9tZS1vcy1saXN0QGdub21lLm9yZz6JATgEEwECACIFAlUUCGcCGwMGCwkIBwMCBhUIAgkKCwQWAgMBAh4BAheAAAoJEArkz6VV0VKBa5cH/0vXa31YgEjNk78gGFXqnQxdD1WYA87OYxDi189l4lA802EFTF4wCBuZyDOqdd5BhS3Ab0cR778DmZXRUP2gwe+1zTJypU2JMnDpkwJ4NK1VP6/tE4SAPrznBtmb76BKaWBqUfZ9Wq1zg3ugvqkZB/Exq+usypIOwQVp1KL58TrjBRda0HvRctzkNhr0qYAtkfLFe0GvksBp4vBm8uGwAx7fw/HbhIjQ9pekTwvB+5GwDPO/tSip/1bQfCS+XJB8Ffa04HYPLGedalnWBrwhYY+G/kn5Zh9L/AC8xeLwTJTHM212rBjPa9CWs9C6a57MSaeGIEHLC1hEyiJJ15w8jmY=
DeployCollectionID=org\&.gnome\&.Apps
.fi
.if n \{\
.RE
.\}
.SH "SEE ALSO"
.PP
\fBflatpak\fR(1),
\fBflatpak-remote-add\fR(1),
\fBflatpak-flatpakref\fR(5)