wwctl image import

Import an image into Warewulf

Synopsis

This command will pull and import an image into Warewulf from SOURCE, optionally renaming it to NAME. The SOURCE must be in a supported URI format. Formats are:

• docker://registry.example.org/example:latest

• docker-daemon://example:latest

• file://path/to/archive/tar/ball

• /path/to/archive/tar/ball

• file://path/to/image.sif

• /path/to/image.sif

• /path/to/chroot/

SIF images are detected by their contents and must have a squashfs primary system partition. They are extracted with unsquashfs (squashfs-tools); Apptainer and Singularity are not required. An existing image cannot be updated from a SIF image with –update; use –force to replace it. Imported images are used to create bootable images.

wwctl image import [OPTIONS] SOURCE [NAME]

Examples

wwctl image import docker://ghcr.io/warewulf/warewulf-rockylinux:8 rockylinux-8

Options

-b, --build             Build image after pulling
-f, --force             Remove existing image and import new image with that name
-h, --help              help for import
    --nohttps           Ignore wrong TLS certificates, supersedes env WAREWULF_OCI_NOHTTPS
    --password string   Set password for the access to the registry, supersedes env WAREWULF_OCI_PASSWORD
    --platform string   Set other hardware platform e.g. amd64 or arm64, supersedes env WAREWULF_OCI_PLATFORM
    --syncuser          Synchronize UIDs/GIDs from host to image
-u, --update            Overwrite files in an existing image with the files of remote image
    --username string   Set username for the access to the registry, supersedes env WAREWULF_OCI_USERNAME

Options inherited from parent commands

-d, --debug                 Run with debugging messages enabled.
-v, --verbose               Run with increased verbosity.
    --warewulfconf string   Set the warewulf configuration file

SEE ALSO

• wwctl image - Operating system image management