opschain admin packs pin
Included from Basic tier
Marks one installed version as the pack's unversioned resolution
target: a packs.yaml declaration that names the pack without a
version: seals this version the next time a template version
resolves. Template versions that already resolved keep the exact
version they sealed — pinning steers future resolutions only, which is
what makes it the rollback lever: pin the prior version and re-resolve.
--clear removes the pin, restoring the default — unversioned
declarations resolve the highest installed semantic version.
The pin is the estate default for declarations without a
version: — what a new or refetched template version seals unless the
version carries an explicit per-version pin of its own. A single
template version is moved onto a specific pack version with the pack
option of opschain templates version upsert (or from the GUI's Sealed
packs panel), and that choice survives later fetches; an empty value
clears it back to this pin. opschain templates re-resolve rolls the
estate onto the pin (else the highest installed), and, when it names a
version, writes that version as every cut version's explicit pin
(opschain docs cli/templates-version-upsert,
opschain docs cli/templates-re-resolve).
opschain admin packs pin opschain-pack-infrastructure 1.2.2
Pinned opschain-pack-infrastructure to version 1.2.2
opschain admin packs pin opschain-pack-infrastructure --clear
Cleared the pin on opschain-pack-infrastructure — unversioned declarations resolve the highest installed version again
-o, --output json|yaml emits the pinned version row (or
{"name": "...", "pinned": false} for --clear).
Flags
| Flag | Meaning |
|---|---|
--clear | Clear the pack's pin instead of setting one. |
--server <url> | Server base URL (default: the active context / OPSCHAIN_SERVER). |
--auth-token <token> | Admin bearer token override (default: your opschain login session, then $OPSCHAIN_ADMIN_TOKEN, then the token stored by opschain admin login). |
See also
opschain docs cli/admin-packs— the family overview and resolution rules.opschain docs cli/templates-version-upsert— one template version's explicit pack pin (the pack option,<name>=<version>).