containers-storage-applydiff(1)

containers-storage-applydiff1

Apply a layer diff to a layer

Usage

containers-storage apply-diff [options []] layerNameOrID [referenceLayerNameOrID]

Overview

When a layer is first created, 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. A layer diff takes the form of a (possibly compressed) tar archive with additional information present in its headers, and can be produced by running containers-storage diff or an equivalent.

Layer diffs are not typically applied manually. More often they are applied by a tool which is being used to import an entire image, such as skopeo.

Options

-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.

Examples

containers-storage apply-diff -f 71841c97e320d6cde.tar.gz layer1

Releases

4 releases since Debian 11 (Bullseye); the text changed 2 times.

  1. 11
  2. 12–13
  3. Arch

From containers-common 1:0.69.2-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.