ostree-remote1
Control remote repository configuration
Usage
ostree remote
add
[OPTIONS ...]
NAME
URL
[BRANCH ...]
ostree remote
delete
NAME
ostree remote
show-url
NAME
ostree remote
list
[OPTIONS ...]
NAME
ostree remote
gpg-import
[OPTIONS ...]
NAME
[KEY-ID ...]
ostree remote
gpg-list-keys
NAME
ostree remote
refs
NAME
ostree remote
summary
[OPTIONS ...]
NAME
ostree remote
add-cookie
NAME
DOMAIN
PATH
COOKIE_NAME
VALUE
ostree remote
delete-cookie
NAME
DOMAIN
PATH
COOKIE_NAME
ostree remote
list-cookies
NAME
Overview
Changes remote repository configurations. The NAME refers to the name of the remote.
The BRANCH arguments to the add subcommand specifies the configured branches for the remote. See the branches section in ostree.repo-config(5) for more information.
The gpg-import 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 gpg-list-keys subcommand can be used to see the GPG keys currently associated with a remote repository.
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 --keyring nor --stdin options are given, then keys are imported from the user's personal GPG keyring.
The various cookie related command allow management of a remote specific cookie jar.
Options
-
--set="KEY=VALUE" -
Set config option KEY=VALUE for remote.
-
--if-not-exists -
Do nothing if the provided remote exists.
-
--force -
Replace the provided remote if it exists.
-
--no-gpg-verify -
Disable GPG verification.
-
--gpg-import=FILE -
Import one or more GPG keys from a file.
Equivalent to ostree remote gpg-import --keyring=FILE.
-
--collection-id=COLLECTION-ID -
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.
Options
-
-u, --show-urls -
Show remote URLs in list
Options
-
--revision, -r -
Also print the revisions for each ref. The revisions will be separated by a tab character.
-
--cache-dir=DIR -
Use an alternate cache directory in DIR.
Options
-
-k, --keyring=FILE -
Import one or more keys from a file.
This option may be repeated to import from multiple files, but may not be used in combination with
--stdin.
-
--stdin -
Import one or more keys from standard input.
This option may not be used in combination with
--keyring.
Options
-
--cache-dir=DIR -
Use an alternate cache directory in DIR.
-
--raw -
Show raw variant data
Examples
$ ostree remote show-url local
http://192.168.122.1/repo
Releases
6 releases since Debian 9 (Stretch); the text changed 5 times.
--cache-dir since Debian 13 (Trixie);
--collection-id since Debian 10 (Buster);
--force since Debian 11 (Bullseye);
--if-not-exists since Debian 11 (Bullseye);
--revision since Debian 13 (Trixie);
-r since Debian 13 (Trixie).