flatpak-remote-add man page

flatpak-remote-add ā€” Add a remote repository


Add from a .flatpakrepo file:

flatpak remote-add [OPTION...] [--from] NAME LOCATION

Manually specify repo uri and options:

flatpak remote-add [OPTION...] NAME LOCATION


Adds a remote repository to the flatpak repository configuration. [NAME] is the name for the new remote, and [LOCATION] is a url or pathname. The [LOCATION] is either a flatpak repository, or a .flatpakrepo file which describes a repository. In the former case you may also have to specify extra options, such as the gpg key for the repo.

Unless overridden with the --user or --installation options, this command changes the default system-wide installation.


The following options are understood:

-h, --help

Show help options and exit.


Assume the URI is a .flatpakrepo file rather than the repository itself. This is enabled by default if the extension is .flatpakrepo, so generally you don't need this option.


Modify the per-user configuration.


Modify the default system-wide configuration.


Modify a system-wide installation specified by NAME among those defined in /etc/flatpak/installations.d/. Using --installation=default is equivalent to using --system.


Disable GPG verification for the added remote.


Set the priority for the remote. Default is 1, higher is more prioritized. This is mainly used for graphical installation tools.


Mark the remote as not enumerated. This means the remote will not be used to list applications, for instance in graphical installation tools.


Mark the remote as not to be used for automatic runtime dependency resolution.


Do nothing if the provided remote already exists.


Disable the added remote.


A title for the remote, e.g. for display in a UI.


A default branch for the remote, mainly for use in a UI.


Import gpg keys from the specified keyring file as trusted for the new remote. If the file is - the keyring is read from standard input.


This is a OCI format registry rather than a regular flatpak repository.

-v, --verbose

Print debug information during command processing.


Print OSTree debug information during command processing.


Print version information and exit.


$ flatpak remote-add gnome https://sdk.gnome.org/gnome.flatpakrepo

$ flatpak --user remote-add --no-gpg-verify test-repo https://people.gnome.org/~alexl/gnome-sdk/repo/

See Also

flatpak(1), flatpak-remote-modify(1), flatpak-remote-delete(1), flatpak-remotes(1), flatpak-flatpakrepo(1)

Referenced By

flatpak(1), flatpak-flatpakrepo(5), flatpak-remote-delete(1), flatpak-remote-modify(1), flatpak-remotes(1).

flatpak remote-add