'\" t
.\"     Title: ostree find-remotes
.\"    Author: Matthew Leeds <matthew.leeds@endlessm.com>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 05/27/2023
.\"    Manual: ostree find-remotes
.\"    Source: OSTree
.\"  Language: English
.\"
.TH "OSTREE FIND\-REMOTES" "1" "" "OSTree" "ostree find-remotes"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "NAME"
ostree-find-remotes \- Find remotes to serve the given refs
.SH "SYNOPSIS"
.HP \w'\fBostree\ find\-remotes\fR\ 'u
\fBostree find\-remotes\fR [OPTIONS...] {COLLECTION\-ID} {REF} [COLLECTION\-ID\ REF...]
.SH "DESCRIPTION"
.PP
OSTree has the ability to pull not just from the configured remote servers but also from peer computers on the LAN and from mounted filesystems such as USB drives\&. This functionality requires the use of collection IDs and GPG verification\&.
.PP
The
\fBfind\-remotes\fR
command searches for remotes which claim to provide one or more of the given COLLECTION\-ID REF pairs and prints information about them, with remotes sorted by latency (Mounts > LAN > Internet)\&. By default, OSTree searches for remotes in configuration files, on mounted filesystems (in a well\-known location), and on the LAN using Avahi\&. Searching for LAN remotes requires OSTree to have been compiled with Avahi support, and it requires an Avahi daemon to be running\&. You can override the default set of finders (sources for remotes) using the
\fB\-\-finders\fR
option documented below\&.
.PP
The
\fBcreate\-usb\fR
command is the recommended way to put refs on a USB such that
\fBfind\-remotes\fR
will discover them\&. See
\fBostree-create-usb\fR(1)\&.
.SH "OPTIONS"
.PP
\fB\-\-cache\-dir\fR=DIR
.RS 4
Use an alternate cache directory in
DIR\&.
.RE
.PP
\fB\-\-disable\-fsync\fR
.RS 4
Do not invoke fsync()\&.
.RE
.PP
\fB\-\-finders\fR=FINDERS
.RS 4
Use the specified comma separated list of finders rather than the default set\&. Possible values:
config,
lan, and
mount
(or any combination thereof)\&.
.RE
.PP
\fB\-\-pull\fR
.RS 4
Pull the most recent commit found for each ref\&.
.RE
.PP
\fB\-\-mirror\fR
.RS 4
Do a mirror pull (see the documentation for
\fBostree pull \-\-mirror\fR)\&. This option can only be used in combination with
\fB\-\-pull\fR\&.
.RE
.SH "EXAMPLE"
.PP
\fB$ ostree find\-remotes \-\-finders=mount,lan com\&.exampleos\&.Os exampleos/x86_64/standard\fR
.sp
.if n \{\
.RS 4
.\}
.nf
Result 0: http://10\&.0\&.64\&.202:43381/0
 \- Finder: OstreeRepoFinderAvahi
 \- Keyring: exampleos\&.trustedkeys\&.gpg
 \- Priority: 60
 \- Summary last modified: 2018\-01\-12T19:00:28Z
 \- Refs:
    \- (com\&.exampleos\&.Os, exampleos/x86_64/standard) = c91acd964b3fda561b87bfb7f7c80e36220d76b567f0ce90c0e60742ef33c360

1/1 refs were found\&.
.fi
.if n \{\
.RE
.\}