dwww Home | Manual pages | Find package

containers-storage import-layer - Import files to a new layer

containers-storage       import-layer       [options       [...]]
[parentLayerNameOrID]

This subcommand is a combination  of  containers-storage  create-
layer and containers-storage apply-diff.

When  a  layer  is  first created with containers-storage create-
layer, it contains no changes relative to its parent layer.   The
layer  can either be mounted read-write and its contents modified
directly, or contents can be added (or  removed)  by  applying  a
layer diff by running containers-storage apply-diff.

-n name

Sets an optional name for the layer. If a name is already in use,
an error is returned.

-i | --id ID

Sets  the  ID  for  the  layer.  If  none  is  specified,  one is
generated.

-f | --file filename

Specifies the name of a file from which the diff should be  read.
If this option is not used, the diff is read from standard input.

-l | --label mount-label

Sets  the  label  which  should be assigned as an SELinux context
when mounting the layer.

-r | --readonly

Mark the layer as readonly.

-j | --json

Prefer JSON output.

--uidmap

UID map specified in the format expected by subuid. It cannot  be
specified simultaneously with --hostuidmap.

--gidmap

GID  map specified in the format expected by subgid. It cannot be
specified simultaneously with --hostuidmap.

--hostuidmap

Force host UID map. It cannot be  specified  simultaneously  with
neither --uidmap nor --subuidmap.

--hostgidmap

Force  host  GID  map. It cannot be specified simultaneously with
neither --gidmap nor --subgidmap.

--subuidmap username

Create UID map for username using the data from  /etc/subuid.  It
cannot be specified simultaneously with --hostuidmap.

--subgidmap group-name

Create GID map for group-name using the data from /etc/subgid. It
cannot be specified simultaneously with --hostuidmap.

containers-storage  import-layer  -f  71841c97e320d6cde.tar.gz -n
new-layer somelayer

containers-storage-create-layer(1)      containers-storage-apply-
diff(1)

Generated by dwww version 1.16 on Thu Nov 19 23:16:12 CET 2026.