---
name: "flatpakrepo"
section: "5"
platform: "linux"
package: "flatpak"
version: "1:1.18.4-2"
release: "Arch Linux 2026-11-01"
platforms: ["linux"]
url: "https://new.carta.tech/flatpakrepo"
---

# flatpakrepo(5)

Reference to a remote

## NAME

flatpakrepo - Reference to a remote

## DESCRIPTION

Flatpak uses flatpakrepo files to share information about remotes. The flatpakrepo file contains enough information to add the remote. Use the **flatpak remote-add --from** command to do so.

flatpakrepo files may also contain additional information that is useful when displaying a remote to the user, e.g. in an app store.

The filename extension commonly used for flatpakrepo files is .flatpakrepo.

flatpakrepo files can also be placed in /usr/share/flatpak/remotes.d/ and /etc/flatpak/remotes.d/ to statically preconfigure system-wide remotes. Such files must use the .flatpakrepo extension. If a file with the same name exists in both, the file under /etc will take precedence.

## FILE FORMAT

The flatpakrepo file is using the same .ini file format that is used for systemd unit files or application .desktop files.

### \[Flatpak Repo\]

All the information is contained in the \[Flatpak Repo\] group.

The following keys can be present in this group:

**Version** (uint64)

The version of the file format, must be 1 if present.

**Url** (string)

The url for the remote. This key is mandatory.

**GPGKey** (string)

The base64-encoded gpg key for the remote.

**DefaultBranch** (string)

The default branch to use for this remote.

**Subset** (string)

Limit the remote to the named subset of refs.

**Title** (string)

The title of the remote. This should be a user-friendly name that can be displayed e.g. in an app store.

**Comment** (string)

A short summary of the remote, for display e.g. in an app store.

**Description** (string)

A longer description of the remote, for display e.g. in an app store.

**Icon** (string)

The url for an icon that can be used to represent the remote.

**Homepage** (string)

The url of a webpage describing the remote.

**Filter** (string)

The path of a local file to use to filter remote refs. See [**flatpak-remote-add**(1)](/flatpak-remote-add/1.md) for details on the format of the file.

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.

**DeploySideloadCollectionID** (string)

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 (see [**flatpak**(1)](/flatpak/1.md)). It is recommended to use this key over DeployCollectionID or CollectionID because only newer clients (Flatpak 1.12.8 or later) pay attention to it (and older clients don't handle collection IDs properly).

**DeployCollectionID** (string)

This is deprecated but still supported for backwards compatibility. Use DeploySideloadCollectionID instead.

**CollectionID** (string)

This is deprecated but still supported for backwards compatibility. Use DeploySideloadCollectionID instead.

## EXAMPLE

```
[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
```

## SEE ALSO

[**flatpak**(1)](/flatpak/1.md), [**flatpak-remote-add**(1)](/flatpak-remote-add/1.md), [**flatpakref**(5)](/flatpakref/5.md)