NAME¶

wwctl-image-import - Import an image into Warewulf

SYNOPSIS¶

wwctl image import [OPTIONS] SOURCE [NAME]

DESCRIPTION¶

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
* /path/to/chroot/ Imported images are used to create bootable images.

OPTIONS¶

-b, --build[=false] Build image after pulling

-f, --force[=false] Force overwrite of an existing image

-h, --help[=false] help for import

--nohttps[=false] Ignore wrong TLS certificates, superseedes env WAREWULF_OCI_NOHTTPS

--password="" Set password for the access to the registry, superseedes env WAREWULF_OCI_PASSWORD

--platform="" Set other hardware platform e.g. amd64 or arm64, superseedes env WAREWULF_OCI_PLATFORM

--syncuser[=false] Synchronize UIDs/GIDs from host to image

-u, --update[=false] Update and overwrite an existing image

--username="" Set username for the access to the registry, superseedes env WAREWULF_OCI_USERNAME

OPTIONS INHERITED FROM PARENT COMMANDS¶

-d, --debug[=false] Run with debugging messages enabled.

-v, --verbose[=false] Run with increased verbosity.

--warewulfconf="" Set the warewulf configuration file

EXAMPLE¶

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

SEE ALSO¶

wwctl-image(1)

HISTORY¶

8-Sep-2025 Auto generated by spf13/cobra