LinuxCommandLibrary

importctl

manages disk images for systemd containers and system extensions

TLDR

Download a tarball image from URL
$ sudo importctl pull-tar [URL] [path/to/directory]
copy
Pull a raw or qcow2 disk image
$ sudo importctl pull-raw [https://example.com/source.ext] [name] --class=[machine|portable|sysext|confext]
copy
Import a raw disk image
$ importctl import-raw [path/to/file.ext] [name] --class=[machine|portable|sysext|confext]
copy
Export a container image as tarball
$ importctl export-tar --class=[machine|portable|sysext|confext] [name] [path/to/file.ext]
copy

SYNOPSIS

importctl command [options]

DESCRIPTION

importctl manages disk images for systemd containers and system extensions. It can download, import, and export various image formats including tarballs, raw disk images, and qcow2 virtual machine images.
The tool integrates with systemd-machined and systemd-importd services to handle image management for containers, portable services, and system/configuration extensions.

PARAMETERS

pull-tar URL NAME

Download and import tarball from URL
pull-raw URL NAME
Download and import raw/qcow2 disk image
import-tar FILE NAME
Import local tarball into image directory
import-raw FILE NAME
Import local raw disk image
export-tar NAME FILE
Export container as tarball
export-raw NAME FILE
Export container as raw disk image
--class TYPE
Image class: machine, portable, sysext, confext

CAVEATS

Requires systemd and appropriate services running. Some operations require root privileges. Network operations depend on systemd-importd service.

HISTORY

importctl is part of systemd, introduced to provide a unified interface for managing container and extension images. It replaces older, more fragmented approaches to image management in the systemd ecosystem.

SEE ALSO

> TERMINAL_GEAR

Curated for the Linux community

Copied to clipboard