COSIGN(1)

πŸ“¦
version 3.1.1 Β· 4 versions
, in ubuntu stonking

πŸŽ€ NAME πŸŽ€

okay so bestie, welcome to the COSIGN(1) page πŸ’– β€” cosign is the Container Signing/Verification/Storage tool. that's the whole vibe. signing, verifying, storing. in a registry. iconic.


✨ DESCRIPTION ✨

fr fr, here's the tea: cosign is a tool for Container Signing, Verification and Storage in an OCI registry. it's giving supply-chain-security main character energy 🫢

here's how you call it:

Usage: cosign [command]

🌸 Available Commands 🌸

like, there are SO many subcommands, and you're gonna want all of them:

  • attest β€” Attest the supplied container image.
  • attest-blob β€” Attest the supplied blob.
  • bundle β€” Interact with a Sigstore protobuf bundle
  • clean β€” Remove all signatures from an image. (yes queen, ALL of them πŸ’…)
  • completion β€” Generate completion script
  • download β€” Provides utilities for downloading artifacts and attached artifacts in a registry
  • env β€” Prints Cosign environment variables
  • generate-key-pair β€” Generates a key-pair.
  • help β€” Help about any command
  • import-key-pair β€” Imports a PEM-encoded RSA or EC private key.
  • initialize β€” Initializes SigStore root to retrieve trusted certificate and key targets for verification.
  • load β€” Load a signed image on disk to a remote registry
  • login β€” Log in to a registry
  • public-key β€” Gets a public key from the key-pair.
  • save β€” Save the container image and associated signatures to disk at the specified directory.
  • sign β€” Sign the supplied container image.
  • sign-blob β€” Sign the supplied blob, outputting the base64-encoded signature to stdout.
  • signing-config β€” Interact with a Sigstore protobuf signing config
  • tree β€” Display supply chain security related artifacts for an image such as signatures, SBOMs and attestations
  • trusted-root β€” Interact with a Sigstore protobuf trusted root
  • verify β€” Verify a signature on the supplied container image
  • verify-attestation β€” Verify an attestation on the supplied container image
  • verify-blob β€” Verify a signature on the supplied blob
  • verify-blob-attestation β€” Verify an attestation on the supplied blob
  • version β€” Prints the version

πŸ”₯ Flags πŸ”₯

no cap, these apply to cosign itself:

  • -h, --help=false β€” help for cosign
  • --output-file='' β€” log output to a file
  • -t, --timeout=3m0s β€” timeout for commands
  • -d, --verbose=false β€” log debug output

πŸ’œ Additional help topics πŸ’œ

a lil extra lore for you:

  • cosign piv-tool β€” This cosign was not built with piv-tool support!
  • cosign pkcs11-tool β€” This cosign was not built with pkcs11-tool support!
bestie, heads up: those two tool topics literally just tell you this cosign was not built with that support. no piv-tool, no pkcs11-tool. that's it, that's the message 😭

and when you're lost (we've all been there), remember:

Use "cosign [command] --help" for more information about a command.

and that's the whole page, bestie πŸ’– this was cosign 3.1.1-1, dated July 2026, and you just read the COSIGN(1) manual. go sign something iconic βœ¨πŸ‘‘ no cap.

πŸ“¦ where this page comes from