Skip to content

Skopeo Basics



Skopeo works with API V2 container image registries such as and registries, private registries, local directories and local OCI-layout directories. Skopeo is a command-line tool that provides a simple way to move container images between different registries, such as Docker Hub,, and OpenShift Container Registry.

Benefits of Using Skopeo

  • skopeo is a command line utility that performs various operations on container images and image repositories.
  • skopeo does not require the user to be running as root to do most of its operations.
  • skopeo does not require a daemon to be running to perform its operations.
  • skopeo can work with OCI images as well as the original Docker v2 images.

How to Use Skopeo

Skopeo is a command-line tool that allows you to inspect, copy, and delete container images. Here is a simple example of how to use Skopeo to copy an image from one registry to another:

skopeo copy docker://source-image:tag docker://destination-image:tag
skopeo copy docker:// docker://
skopeo copy oci:busybox_ocilayout:latest dir:existingemptydirectory

In this command, source-image is the name of the image you want to copy, and destination-image is the name of the image you want to create. You can replace tag with a specific version number or use latest to copy the most recent version of the image.

Skopeo also supports other commands, such as inspect to view metadata about an image, and delete to remove an image from a registry.


Leave a message

  • Welcome to visit the knowledge base of SRE and DevOps!
  • License under CC BY-NC 4.0
  • Made with Material for MkDocs and improve writing by generative AI tools
  • Copyright issue feedback, replace # with @