1OSTREE FIND-REMOTES(1) ostree find-remotes OSTREE FIND-REMOTES(1)
2
3
4
6 ostree-find-remotes - Find remotes to serve the given refs
7
9 ostree find-remotes [OPTIONS...] {COLLECTION-ID} {REF}
10 [COLLECTION-ID REF...]
11
13 OSTree has the ability to pull not just from the configured remote
14 servers but also from peer computers on the LAN and from mounted
15 filesystems such as USB drives. This functionality requires the use of
16 collection IDs and GPG verification.
17
18 The find-remotes command searches for remotes which claim to provide
19 one or more of the given COLLECTION-ID REF pairs and prints information
20 about them, with remotes sorted by latency (Mounts > LAN > Internet).
21 By default, OSTree searches for remotes in configuration files, on
22 mounted filesystems (in a well-known location), and on the LAN using
23 Avahi. Searching for LAN remotes requires OSTree to have been compiled
24 with Avahi support, and it requires an Avahi daemon to be running. You
25 can override the default set of finders (sources for remotes) using the
26 --finders option documented below.
27
28 The create-usb command is the recommended way to put refs on a USB such
29 that find-remotes will discover them. See ostree-create-usb(1).
30
32 --cache-dir=DIR
33 Use an alternate cache directory in DIR.
34
35 --disable-fsync
36 Do not invoke fsync().
37
38 --finders=FINDERS
39 Use the specified comma separated list of finders rather than the
40 default set. Possible values: config, lan, and mount (or any
41 combination thereof).
42
43 --pull
44 Pull the most recent commit found for each ref.
45
46 --mirror
47 Do a mirror pull (see the documentation for ostree pull --mirror).
48 This option can only be used in combination with --pull.
49
51 $ ostree find-remotes --finders=mount,lan com.exampleos.Os
52 exampleos/x86_64/standard
53
54 Result 0: http://10.0.64.202:43381/0
55 - Finder: OstreeRepoFinderAvahi
56 - Keyring: exampleos.trustedkeys.gpg
57 - Priority: 60
58 - Summary last modified: 2018-01-12T19:00:28Z
59 - Refs:
60 - (com.exampleos.Os, exampleos/x86_64/standard) = c91acd964b3fda561b87bfb7f7c80e36220d76b567f0ce90c0e60742ef33c360
61
62 1/1 refs were found.
63
64
65
66OSTree OSTREE FIND-REMOTES(1)