Skip to main content

skopeo CLI reference

ModularPipelines.Skopeo provides strongly typed access to the skopeo CLI.

Executable prerequisite​

This package does not install the skopeo executable. Install it separately and ensure skopeo is available on PATH.

Follow the executable's official documentation for installation instructions.

Package installation​

dotnet add package ModularPipelines.Skopeo

Resolve the service with context.Tools.Skopeo. Projects using C# 13 or another .NET language can use context.Tools.Get<ModularPipelines.Skopeo.Services.ISkopeo>() instead.

Module example​

Resolve the service in a module, then select a command from the table below. A runnable example is omitted when no command has complete safety metadata:

var skopeo = context.Tools.Skopeo;

Global options​

Global options are rendered before the selected subcommand.

CLI optionPropertyAvailabilityDescription
--command-timeoutCommandTimeoutAll editionstimeout for the command execution
--debugDebugAll editionsenable debug output
--insecure-policyInsecurePolicyAll editionsrun the tool without any policy check
--override-archOverrideArchAll editionsuse ARCH instead of the architecture of the machine for choosing images
--override-osOverrideOsAll editionsuse OS instead of the running OS for choosing images
--override-variantOverrideVariantAll editionsuse VARIANT instead of the running architecture variant for choosing images
--policyPolicyAll editionsPath to a trust policy file
--registries.dRegistriesDAll editionsuse registry configuration files in DIR (e.g. for container signature storage)
--tmpdirTmpdirAll editionsdirectory used to store temporary files

Commands​

CLI commandOptions record
skopeo copySkopeoCopyOptions
skopeo deleteSkopeoDeleteOptions
skopeo generate-sigstore-keySkopeoGenerateSigstoreKeyOptions
skopeo inspectSkopeoInspectOptions
skopeo list-tagsSkopeoListTagsOptions
skopeo loginSkopeoLoginOptions
skopeo logoutSkopeoLogoutOptions
skopeo manifest-digestSkopeoManifestDigestOptions
skopeo standalone-signSkopeoStandaloneSignOptions
skopeo standalone-verifySkopeoStandaloneVerifyOptions
skopeo syncSkopeoSyncOptions