1FLATPAK REMOTE-ADD(1)         flatpak remote-add         FLATPAK REMOTE-ADD(1)
2
3
4

NAME

6       flatpak-remote-add - Add a remote repository
7

SYNOPSIS

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

DESCRIPTION

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
18       Unless overridden with the --user or --installation options, this
19       command changes the default system-wide installation.
20

OPTIONS

22       The following options are understood:
23
24       -h, --help
25           Show help options and exit.
26
27       --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
32       --user
33           Modify the per-user configuration.
34
35       --system
36           Modify the default system-wide configuration.
37
38       --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
43       --no-gpg-verify
44           Disable GPG verification for the added remote.
45
46       --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
50       --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
55       --no-use-for-deps
56           Mark the remote as not to be used for automatic runtime dependency
57           resolution.
58
59       --if-not-exists
60           Do nothing if the provided remote already exists.
61
62       --disable
63           Disable the added remote.
64
65       --title=TITLE
66           A title for the remote, e.g. for display in a UI.
67
68       --comment=COMMENT
69           A single-line comment for the remote, e.g. for display in a UI.
70
71       --description=DESCRIPTION
72           A full-paragraph description for the remote, e.g. for display in a
73           UI.
74
75       --homepage=URL
76           URL for a website for the remote, e.g. for display in a UI.
77
78       --icon=URL
79           URL for an icon for the remote, e.g. for display in a UI.
80
81       --default-branch=BRANCH
82           A default branch for the remote, mainly for use in a UI.
83
84       --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
92           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
97           Here is an example filter file:
98
99               # 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
106
107       --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
112       --authenticator-name=NAME
113           Specify the authenticator to use for the remote.
114
115       --authenticator-option=KEY=VALUE
116           Specify an authenticator option for the remote.
117
118       --authenticator-install
119           Enable auto-installation of authenticator.
120
121       --no-authenticator-install
122           Disable auto-installation of authenticator.
123
124       -v, --verbose
125           Print debug information during command processing.
126
127       --ostree-verbose
128           Print OSTree debug information during command processing.
129

EXAMPLES

131       $ flatpak remote-add gnome https://sdk.gnome.org/gnome.flatpakrepo
132
133       $ flatpak --user remote-add --no-gpg-verify test-repo
134       https://people.gnome.org/~alexl/gnome-sdk/repo/
135

SEE ALSO

137       flatpak(1), flatpak-remote-modify(1), flatpak-remote-delete(1),
138       flatpak-remotes(1), flatpak-flatpakrepo(5)
139
140
141
142flatpak                                                  FLATPAK REMOTE-ADD(1)
Impressum