Scroll to navigation



flatpak-remote-add - Add a remote repository


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.

-v, --verbose

Print debug information during command processing.


Print OSTree debug information during command processing.


$ flatpak remote-add gnome

$ flatpak --user remote-add --no-gpg-verify test-repo


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