1apptainer(1)                                                      apptainer(1)
2
3
4

NAME

6       apptainer-overlay-create - Create EXT3 writable overlay image
7
8
9

SYNOPSIS

11       apptainer overlay create  image
12
13
14

DESCRIPTION

16       The  overlay create command allows creating EXT3 writable overlay image
17       either
18         as a single EXT3 image or by adding it automatically to  an  existing
19       SIF image.
20
21
22

OPTIONS

24       --create-dir=[]      directory to create as part of the overlay layout
25
26
27       -f,  --fakeroot[=false]       make overlay layout usable by actions run
28       with --fakeroot
29
30
31       -h, --help[=false]      help for create
32
33
34       -s, --size=64      size of the EXT3 writable overlay in MiB
35
36
37       -S, --sparse[=false]      create a sparse overlay
38
39
40

EXAMPLE

42                To create and add a writable overlay to an existing SIF image:
43                $ apptainer overlay create --size 1024 /tmp/image.sif
44
45                To create a single EXT3 writable overlay image:
46                $ apptainer overlay create --size 1024 /tmp/my_overlay.img
47
48                To create a sparse overlay when creating a new ext3 file system image:
49                $ apptainer overlay create --size 1024 --sparse /tmp/ext3_overlay.img
50
51                To create an EXT3 writable overlay image for use with --fakeroot actions:
52                $ apptainer overlay create --fakeroot --size 1024 /tmp/my_overlay.img
53
54
55
56

SEE ALSO

58       apptainer-overlay(1)
59
60
61

HISTORY

63       10-Jan-2023 Auto generated by spf13/cobra
64
65
66
67Auto generated by spf13/cobra      Jan 2023                       apptainer(1)