oz0 index add
For: Operators and developers looking up a command.
Add a plugin index: https:// (or http://), or file:// in dev mode. The URL may not carry a user name or password: every user of the cluster sees it. The server fetches it. Without --root-key it is not used yet: index list shows the fingerprint of the root key its copy names, which you compare with the one its publisher gives you, and then index trust <name> --fingerprint <SHA256:...> pins that key.
With --file instead of a URL, the index is imported: the server never fetches it, in any mode, and takes each new copy only from index refresh <name> --file, checking its signatures, expiry and version (an older copy is refused as a rollback) as for a fetched one; for clusters with no way out, such as one installing from an offline folder. Cluster admins may.
Usage
oz0 index add <name> <url> | add <name> --file index.json [flags]
Flags
| Flag | Type | Default | Description |
|---|---|---|---|
--allow-withdrawn | bool | install withdrawn and quarantined versions with a warning, instead of refusing them | |
--file | string | import the index from this copy of its signed index.json instead of a URL; it is never fetched | |
--json | bool | print JSON instead of a table | |
--root-key | string | the index's root key (Ed25519, base64), from its publisher: trusts the index at once |
Inherited flags
| Flag | Type | Default | Description |
|---|---|---|---|
--context | string | $OZ0_CONTEXT or <config dir>/orchestrator-zero/context.json | CLI context file written by server init |
--log-level | string | info | log level: debug, info, warn or error |
See all oz0 commands and the global flags.