'\" t
.\"     Title: ostree remote
.\"    Author: Colin Walters <walters@verbum.org>
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net/>
.\"      Date: 02/19/2024
.\"    Manual: ostree remote
.\"    Source: OSTree
.\"  Language: English
.\"
.TH "OSTREE REMOTE" "1" "" "OSTree" "ostree remote"
.\" -----------------------------------------------------------------
.\" * 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-remote \- Control remote repository configuration
.SH "SYNOPSIS"
.HP \w'\fBostree\ remote\ add\fR\ 'u
\fBostree remote add\fR [OPTIONS...] {NAME} {URL} [BRANCH...]
.HP \w'\fBostree\ remote\ delete\fR\ 'u
\fBostree remote delete\fR {NAME}
.HP \w'\fBostree\ remote\ show\-url\fR\ 'u
\fBostree remote show\-url\fR {NAME}
.HP \w'\fBostree\ remote\ list\fR\ 'u
\fBostree remote list\fR [OPTIONS...] {NAME}
.HP \w'\fBostree\ remote\ gpg\-import\fR\ 'u
\fBostree remote gpg\-import\fR [OPTIONS...] {NAME} [KEY\-ID...]
.HP \w'\fBostree\ remote\ gpg\-list\-keys\fR\ 'u
\fBostree remote gpg\-list\-keys\fR {NAME}
.HP \w'\fBostree\ remote\ refs\fR\ 'u
\fBostree remote refs\fR {NAME}
.HP \w'\fBostree\ remote\ summary\fR\ 'u
\fBostree remote summary\fR [OPTIONS...] {NAME}
.HP \w'\fBostree\ remote\ add\-cookie\fR\ 'u
\fBostree remote add\-cookie\fR {NAME} {DOMAIN} {PATH} {COOKIE_NAME} {VALUE}
.HP \w'\fBostree\ remote\ delete\-cookie\fR\ 'u
\fBostree remote delete\-cookie\fR {NAME} {DOMAIN} {PATH} {COOKIE_NAME} {VALUE}
.HP \w'\fBostree\ remote\ list\-cookies\fR\ 'u
\fBostree remote list\-cookies\fR {NAME}
.SH "DESCRIPTION"
.PP
Changes remote repository configurations\&. The NAME refers to the name of the remote\&.
.PP
The
BRANCH
arguments to the
\fBadd\fR
subcommand specifies the configured branches for the remote\&. See the
branches
section in
\fBostree.repo-config\fR(5)
for more information\&.
.PP
The
\fBgpg\-import\fR
subcommand can associate GPG keys to a specific remote repository for use when pulling signed commits from that repository (if GPG verification is enabled)\&. The
\fBgpg\-list\-keys\fR
subcommand can be used to see the GPG keys currently associated with a remote repository\&.
.PP
The GPG keys to import may be in binary OpenPGP format or ASCII armored\&. The optional
[KEY\-ID]
list can restrict which keys are imported from a keyring file or input stream\&. All keys are imported if this list is omitted\&. If neither
\fB\-\-keyring\fR
nor
\fB\-\-stdin\fR
options are given, then keys are imported from the user\*(Aqs personal GPG keyring\&.
.PP
The various cookie related command allow management of a remote specific cookie jar\&.
.SH "\*(AqADD\*(Aq OPTIONS"
.PP
\fB\-\-set\fR="KEY=VALUE"
.RS 4
Set config option KEY=VALUE for remote\&.
.RE
.PP
\fB\-\-if\-not\-exists\fR
.RS 4
Do nothing if the provided remote exists\&.
.RE
.PP
\fB\-\-force\fR
.RS 4
Replace the provided remote if it exists\&.
.RE
.PP
\fB\-\-no\-gpg\-verify\fR
.RS 4
Disable GPG verification\&.
.RE
.PP
\fB\-\-gpg\-import\fR=FILE
.RS 4
Import one or more GPG keys from a file\&.
.sp
Equivalent to
\fBostree remote gpg\-import \-\-keyring=FILE\fR\&.
.RE
.PP
\fB\-\-collection\-id\fR=COLLECTION\-ID
.RS 4
Set the collection ID for the remote to a value provided by the repository owner, which allows refs from this remote to be shared peer to peer\&.
.RE
.SH "\*(AqLIST\*(Aq OPTIONS"
.PP
\fB\-u, \-\-show\-urls\fR
.RS 4
Show remote URLs in list
.RE
.SH "\*(AqREFS\*(Aq OPTIONS"
.PP
\fB\-\-revision\fR, \fB\-r\fR
.RS 4
Also print the revisions for each ref\&. The revisions will be separated by a tab character\&.
.RE
.PP
\fB\-\-cache\-dir\fR=DIR
.RS 4
Use an alternate cache directory in
DIR\&.
.RE
.SH "\*(AqGPG\-IMPORT\*(Aq OPTIONS"
.PP
\fB\-k, \-\-keyring\fR=FILE
.RS 4
Import one or more keys from a file\&.
.sp
This option may be repeated to import from multiple files, but may not be used in combination with
\fB\-\-stdin\fR\&.
.RE
.PP
\fB\-\-stdin\fR
.RS 4
Import one or more keys from standard input\&.
.sp
This option may not be used in combination with
\fB\-\-keyring\fR\&.
.RE
.SH "\*(AqSUMMARY\*(Aq OPTIONS"
.PP
\fB\-\-cache\-dir\fR=DIR
.RS 4
Use an alternate cache directory in
DIR\&.
.RE
.PP
\fB\-\-raw\fR
.RS 4
Show raw variant data
.RE
.SH "EXAMPLE"
.PP
\fB$ ostree remote show\-url local\fR
.sp
.if n \{\
.RS 4
.\}
.nf
        http://192\&.168\&.122\&.1/repo
.fi
.if n \{\
.RE
.\}