podman-load(1)

Hey bestie! Welcome to podman-load(1) from the General Commands Manual. This is your girl's guide to loading images like a total icon. Let's get into it! 💅

✨ NAME ✨

podman-load — load image(s) from tar archives, directories, or URLs into container storage. No cap, this is the one.

🎀 SYNOPSIS 🎀

Okay so here's the vibe: podman load has two forms, and they're both iconic.

podman load [options]

podman image load [options]

💖 DESCRIPTION 💖

Okay so <pink>podman load</pink> loads a saved image(s) into local container storage from tar archives, directories, or URLs pointing to a tar archive. By default, it reads from stdin—like, it's just waiting for you to pipe something in, bestie. To load from any of the other input sources, use the --input option.

The way this works is: podman load operates on images. It restores an archive created by podman save as the same image, preserving its layers, history and tags. That's the good stuff. This is different from podman import, which builds a new image from a root-filesystem tarball (such as one produced by podman export) with no image history. Not the same vibe at all. To import a container's filesystem instead, see podman-import(1).

Oh, and the local client further supports loading an oci-dir or a docker-dir as created with podman save (1). Slay.

The quiet option suppresses the progress output when set. Because sometimes you just want it to be quiet, you know?

Note: : is a restricted character and cannot be part of the file name. So don't try it, bestie.

🔥 OPTIONS 🔥

• --help, -h — Print usage statement. Simple, but essential.
• --input, -i=input — Load the specified input file or URL instead of reading from stdin. The input can be one of:
  • A local tar archive (uncompressed or compressed)
  • A local OCI or Docker directory layout
  • A URL to a tar archive (not available on macOS and Windows)

NOTE: Use the environment variable TMPDIR to change the temporary storage location of container images. Podman defaults to use /var/tmp. So if you need to move that temp storage, you know what to do.

• --quiet, -q — Suppress the progress output. Because sometimes you just want it to be quiet, bestie.

🌈 EXAMPLES 🌈

Okay, let's see this in action. These examples are giving main character energy. ✨

1. Create an image from a compressed tar file, without showing progress.

$ podman load --quiet -i fedora.tar.gz

2. Create an image from the archive.tar file pulled from a URL, without showing progress.

$ podman load -q -i https://server.com/archive.tar

3. Create an image from a directory created with either podman-save --format oci-dir or --format docker-dir

$ podman load -i fedora/

4. Create an image from stdin using bash redirection from a tar file.

$ podman load < fedora.tar
Getting image source signatures
Copying blob sha256:5bef08742407efd622d243692b79ba0055383bbce12900324f75e56f589aedb0
 0 B / 4.03 MB [---------------------------------------------------------------]
Copying config sha256:7328f6f8b41890597575cbaadc884e7386ae0acc53b747401ebce5cf0d624560
 0 B / 1.48 KB [---------------------------------------------------------------]
Writing manifest to image destination
Storing signatures
Loaded image:  registry.fedoraproject.org/fedora:latest

5. Create an image from stdin using a pipe.

$ cat fedora.tar | podman load
Getting image source signatures
Copying blob sha256:5bef08742407efd622d243692b79ba0055383bbce12900324f75e56f589aedb0
 0 B / 4.03 MB [---------------------------------------------------------------]
Copying config sha256:7328f6f8b41890597575cbaadc884e7386ae0acc53b747401ebce5cf0d624560
 0 B / 1.48 KB [---------------------------------------------------------------]
Writing manifest to image destination
Storing signatures
Loaded image:  registry.fedoraproject.org/fedora:latest

🦋 SEE ALSO 🦋

Check out these other icons: podman(1), podman-save(1). iykyk

⭐ HISTORY ⭐

This page was originally compiled in July 2017 by Urvashi Mohnani umohnani@redhat.com ⟨mailto:umohnani@redhat.com⟩. Queen shit.

---

And that's a wrap on podman-load(1) from the General Commands Manual! Stay slay, bestie. 💖✨