SKOPEO-STANDALONE-VERIFY(1)
π skopeo-standalone-verify β the skopeo-standalone-verify(1) glow-up π
okay bestie, pull up a chair, because this one is a debugging tool and I need you to hear that with your whole chest π«Ά
β¨ NAME β¨
skopeo-standalone-verify β a debugging tool that verifies an image signature from local files. that's it, that's the gig π
πΈ SYNOPSIS πΈ
skopeo standalone-verify manifest docker-reference key-fingerprints signature
π¦ DESCRIPTION π¦
so what are we doing here? we're verifying a signature using local files, and if it works, the digest gets printed. success looks like a little victory lap, no cap π
lowkey important though: this is primarily a debugging tool. it's useful for special cases, and it usually should not be a part of your normal operational workflow. fr fr. also, please consider configuring a signature verification policy file, as per containers-policy.json(5). that's the grown-up move β¨
now the args, one by one, no skipping π
manifestβ path to a file containing the image manifest πdocker-referenceβ a docker reference that's expected to identify the image in the signature π³key-fingerprintsβ identities of trusted signing keys (comma separated), oranyto trust any known key when using a public key file πsignatureβ path to the signature file βοΈ
π¨ Note: if you do use this, make sure that the image can not be changed at the source location between the times of its verification and use. like, between verify o'clock and use o'clock. no sneaky swaps. π
π OPTIONS π
also peep skopeo(1) for options placed before the subcommand name, bestie π
--help,-hβ print usage statement. the classic. the icon. the "what does this even do" button π--public-key-filepublic key file β file containing the public keys to use when verifying signatures. if this is not specified, keys from the GPG homedir are used. so either you hand me the keys, or I go dig through the GPG homedir myself ποΈ
β EXAMPLES β
look at her go π₯Ή
$ skopeo standalone-verify busybox-manifest.json registry.example.com/example/busybox 1D8230F6CDB6A06716E414C1DB72F2188BB46CC8 busybox.signature
Signature verified, digest sha256:20bf21ed457b390829cdbeec8795a7bea1626991fda603e0d01b4e7f60427e55
she ATE. digest printed, verification verified, main character energy confirmed π
π§ NOTES π§
- this command is intended for use with local signatures, e.g. OpenPGP ( other signature formats may be added in the future ), as per
containers-signature(5)ποΈ - furthermore, this command does not interact with the artifacts generated by Docker Content Trust (DCT). for more information, please see
containers-signature(5)<https://github.com/containers/image/blob/main/docs/containers-signature.5.md> π
π₯ SEE ALSO π₯
skopeo(1), containers-signature(5), containers-policy.json(5)
π AUTHORS π
- Antonio Murdaca
runcom@redhat.com<mailto:runcom@redhat.com> - Miloslav Trmac
mitr@redhat.com<mailto:mitr@redhat.com> - Jhon Honce
jhonce@redhat.com<mailto:jhonce@redhat.com>
the legends themselves, we stan π«Ά
and that's the whole page, bestie β this is skopeo-standalone-verify(1), from the skopeo-standalone-verify(1) manual, and yeah the footer is literally just skopeo-standalone-verify(1)() again with no extra source/version or date info, which is its own kind of iconic tbh ππ go verify something local, stay safe, mwah πΈ
π¦ where this page comes from
- alpine 3.24: skopeo-doc 1.20.1-r2 Β· Apache-2.0
- arch rolling: skopeo 1.24.1-1 Β· Apache-2.0
- fedora 43: skopeo 1:1.20.0-2.fc43 Β· Apache-2.0 AND BSD-2-Clause AND BSD-3-Clause AND ISC AND MIT AND MPL-2.0
- fedora 43: skopeo 1:1.22.2-2.fc43
- fedora 43: skopeo 1:1.22.3-1.fc43 Β· Apache-2.0 AND BSD-2-Clause AND BSD-3-Clause AND ISC AND MIT AND MPL-2.0
- fedora 44: skopeo 1:1.22.0-2.fc44 Β· Apache-2.0 AND BSD-2-Clause AND BSD-3-Clause AND ISC AND MIT AND MPL-2.0
- fedora 44: skopeo 1:1.22.3-1.fc44 Β· Apache-2.0 AND BSD-2-Clause AND BSD-3-Clause AND ISC AND MIT AND MPL-2.0
- nixos 26.05: skopeo 1.22.2
- nixpkgs unstable: skopeo 1.24.1
- ubuntu resolute: skopeo 1.21.0~pre1-2build1 Β· Apache-2.0
- ubuntu stonking: skopeo 1.22.0+ds1-1 Β· Apache-2.0
- π girlified by deepseek-ai/DeepSeek-V4.1-Flash on : a language model's rewrite of the original, under its terms