1FLATPAK REMOTE-ADD(1) flatpak remote-add FLATPAK REMOTE-ADD(1)
2
6 flatpak-remote-add - Add a remote repository
7
9 flatpak remote-add [OPTION...] NAME LOCATION
10
12 Adds a remote repository to the flatpak repository configuration. NAME
13 is the name for the new remote, and LOCATION is a url or pathname. The
14 LOCATION is either a flatpak repository, or a .flatpakrepo file which
15 describes a repository. In the former case you may also have to specify
16 extra options, such as the gpg key for the repo.
17 Unless overridden with the --user or --installation options, this
19 command changes the default system-wide installation.
20
22 The following options are understood:
23 -h, --help
25 Show help options and exit.
26 --from
28 Assume the URI is a .flatpakrepo file rather than the repository
29 itself. This is enabled by default if the extension is
30 .flatpakrepo, so generally you don't need this option.
31 --user
33 Modify the per-user configuration.
34 --system
36 Modify the default system-wide configuration.
37 --installation=NAME
39 Modify a system-wide installation specified by NAME among those
40 defined in /etc/flatpak/installations.d/. Using
41 --installation=default is equivalent to using --system.
42 --no-gpg-verify
44 Disable GPG verification for the added remote.
45 --prio=PRIO
47 Set the priority for the remote. Default is 1, higher is more
48 prioritized. This is mainly used for graphical installation tools.
49 --no-enumerate
51 Mark the remote as not enumerated. This means the remote will not
52 be used to list applications, for instance in graphical
53 installation tools.
54 --no-use-for-deps
56 Mark the remote as not to be used for automatic runtime dependency
57 resolution.
58 --if-not-exists
60 Do nothing if the provided remote already exists.
61 --disable
63 Disable the added remote.
64 --title=TITLE
66 A title for the remote, e.g. for display in a UI.
67 --comment=COMMENT
69 A single-line comment for the remote, e.g. for display in a UI.
70 --description=DESCRIPTION
72 A full-paragraph description for the remote, e.g. for display in a
73 UI.
74 --homepage=URL
76 URL for a website for the remote, e.g. for display in a UI.
77 --icon=URL
79 URL for an icon for the remote, e.g. for display in a UI.
80 --default-branch=BRANCH
82 A default branch for the remote, mainly for use in a UI.
83 --filter=PATH
85 Add a local filter to the remote. A filter file is a list of lines,
86 each file starting with "allow" or "deny", and then a glob for the
87 ref to allow or disallow. The globs specify a partial ref (i.e. you
88 can leave out trailing parts which will then match everything), but
89 otherwise only "*" is special, matching anything in that part of
90 the ref.
91 By default all refs are allowed, but if a ref matches a deny rule
93 it is disallowed unless it specifically matches an allow rule. This
94 means you can use this to implement both whitelisting and
95 blacklisting.
96 Here is an example filter file:
98 # This is a whitelist style filter as it denies all first
100 deny *
101 allow runtime/org.freedesktop.*
102 allow org.some.app/arm
103 allow org.signal.Signal/*/stable
104 allow org.signal.Signal.*/*/stable
105 --gpg-import=FILE
108 Import gpg keys from the specified keyring file as trusted for the
109 new remote. If the file is - the keyring is read from standard
110 input.
111 -v, --verbose
113 Print debug information during command processing.
114 --ostree-verbose
116 Print OSTree debug information during command processing.
117
119 $ flatpak remote-add gnome https://sdk.gnome.org/gnome.flatpakrepo
120 $ flatpak --user remote-add --no-gpg-verify test-repo
122 https://people.gnome.org/~alexl/gnome-sdk/repo/
123
125 flatpak(1), flatpak-remote-modify(1), flatpak-remote-delete(1),
126 flatpak-remotes(1), flatpak-flatpakrepo(5)
127flatpak FLATPAK REMOTE-ADD(1)