LinuxCommandLibrary

podman-import

Create container image from filesystem tarball

TLDR

Import tarball as image

$ podman import [file.tar] [image:tag]
copy
Import from URL
$ podman import [https://example.com/rootfs.tar] [image]
copy
Import with changes
$ podman import --change "CMD [/bin/bash]" [file.tar] [image]
copy

SYNOPSIS

podman import [options] path [reference]

DESCRIPTION

podman import creates a new container image from a filesystem tarball (or URL). Unlike podman load, which restores a previously saved image with all its layers and metadata, import creates a flat single-layer image from a root filesystem archive.
The --change option allows applying Dockerfile instructions (like CMD, ENTRYPOINT, ENV) to the imported image. This is typically used with archives created by podman export or other tools that produce root filesystem tarballs.

PARAMETERS

PATH

Tarball path or URL.
REFERENCE
Image name and tag.
--change INSTRUCTION
Apply Dockerfile instruction.
-m, --message MSG
Commit message.

CAVEATS

Creates single layer image. No build history.

HISTORY

podman import provides tarball to image conversion functionality.

SEE ALSO

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard

> TERMINAL_GEAR

Curated for the Linux community