Debian Codegraph @

storage.conf-freebsd

raw
1 # This file is is the configuration file for all tools
2 # that use the containers/storage library. The storage.conf file
3 # overrides all other storage.conf files. Container engines using the
4 # container/storage library do not inherit fields from other storage.conf
5 # files.
6 #
7 # Note: The storage.conf file overrides other storage.conf files based on this precedence:
8 # /usr/local/share/containers/storage.conf
9 # /usr/local/etc/containers/storage.conf
10 # $HOME/.config/containers/storage.conf
11 # $XDG_CONFIG_HOME/containers/storage.conf (If XDG_CONFIG_HOME is set)
12 # See man 5 containers-storage.conf for more information
13 # The "container storage" table contains all of the server options.
14 [storage]
15
16 # Default Storage Driver, Must be set for proper operation.
17 driver = "zfs"
18
19 # Temporary storage location
20 runroot = "/var/run/containers/storage"
21
22 # Primary Read/Write location of container storage
23 graphroot = "/var/db/containers/storage"
24
25 # Optional value for image storage location
26 # If set, it must be different than graphroot.
27
28 # imagestore = ""
29
30 # Storage path for rootless users
31 #
32 # rootless_storage_path = "$HOME/.local/share/containers/storage"
33
34 [storage.options]
35 # Storage options to be passed to underlying storage drivers
36
37 # AdditionalImageStores is used to pass paths to additional Read/Only image stores
38 # Must be comma separated list.
39 additionalimagestores = [
40 ]
41
42 # Root-auto-userns-user is a user name which can be used to look up one or more UID/GID
43 # ranges in the /etc/subuid and /etc/subgid file. These ranges will be partitioned
44 # to containers configured to create automatically a user namespace. Containers
45 # configured to automatically create a user namespace can still overlap with containers
46 # having an explicit mapping set.
47 # This setting is ignored when running as rootless.
48 # root-auto-userns-user = "storage"
49 #
50 # Auto-userns-min-size is the minimum size for a user namespace created automatically.
51 # auto-userns-min-size=1024
52 #
53 # Auto-userns-max-size is the minimum size for a user namespace created automatically.
54 # auto-userns-max-size=65536
55
56 [storage.options.overlay]
57 # ignore_chown_errors can be set to allow a non privileged user running with
58 # a single UID within a user namespace to run containers. The user can pull
59 # and use any image even those with multiple uids. Note multiple UIDs will be
60 # squashed down to the default uid in the container. These images will have no
61 # separation between the users in the container. Only supported for the overlay
62 # and vfs drivers.
63 #ignore_chown_errors = "false"
64
65 # Inodes is used to set a maximum inodes of the container image.
66 # inodes = ""
67
68 # Path to an helper program to use for mounting the file system instead of mounting it
69 # directly.
70 #mount_program = "/usr/bin/fuse-overlayfs"
71
72 # mountopt specifies comma separated list of extra mount options
73 mountopt = "nodev"
74
75 # Set to skip a PRIVATE bind mount on the storage home directory.
76 # skip_mount_home = "false"
77
78 # Set to use composefs to mount data layers with overlay.
79 # use_composefs = "false"
80
81 # Size is used to set a maximum size of the container image.
82 # size = ""
83
84 # ForceMask specifies the permissions mask that is used for new files and
85 # directories.
86 #
87 # The values "shared" and "private" are accepted.
88 # Octal permission masks are also accepted.
89 #
90 # "": No value specified.
91 # All files/directories, get set with the permissions identified within the
92 # image.
93 # "private": it is equivalent to 0700.
94 # All files/directories get set with 0700 permissions. The owner has rwx
95 # access to the files. No other users on the system can access the files.
96 # This setting could be used with networked based homedirs.
97 # "shared": it is equivalent to 0755.
98 # The owner has rwx access to the files and everyone else can read, access
99 # and execute them. This setting is useful for sharing containers storage
100 # with other users. For instance have a storage owned by root but shared
101 # to rootless users as an additional store.
102 # NOTE: All files within the image are made readable and executable by any
103 # user on the system. Even /etc/shadow within your image is now readable by
104 # any user.
105 #
106 # OCTAL: Users can experiment with other OCTAL Permissions.
107 #
108 # Note: The force_mask Flag is an experimental feature, it could change in the
109 # future. When "force_mask" is set the original permission mask is stored in
110 # the "user.containers.override_stat" xattr and the "mount_program" option must
111 # be specified. Mount programs like "/usr/bin/fuse-overlayfs" present the
112 # extended attribute permissions to processes within containers rather then the
113 # "force_mask" permissions.
114 #
115 # force_mask = ""