carta
singularity-overlay-create(1)

singularity-overlay-create1

Create ext3 writable overlay image

Usage

apptainer overlay create image

Overview

The overlay create command allows creating EXT3 writable overlay image either
as a single EXT3 image or by adding it automatically to an existing SIF image.

Options

--create-dir=[]
directory to create as part of the overlay layout

-f, --fakeroot[=false]
make overlay layout usable by actions run with --fakeroot

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

-s, --size=64
size of the EXT3 writable overlay in MiB

-S, --sparse[=false]
create a sparse overlay

Examples

  To create and add a writable overlay to an existing SIF image:
  $ apptainer overlay create --size 1024 /tmp/image.sif
  To create a single EXT3 writable overlay image:
  $ apptainer overlay create --size 1024 /tmp/my_overlay.img
  To create a sparse overlay when creating a new ext3 file system image:
  $ apptainer overlay create --size 1024 --sparse /tmp/ext3_overlay.img
  To create an EXT3 writable overlay image for use with --fakeroot actions:
  $ apptainer overlay create --fakeroot --size 1024 /tmp/my_overlay.img

History

22-Sep-2026 Auto generated by spf13/cobra

From apptainer 1.5.4-1 in Arch Linux 2026-11-01. Parsed by carta from the page's man source.