|
 |
5849f4 |
% storage.conf(5) Container Storage Configuration File
|
|
|
5849f4 |
% Dan Walsh
|
|
|
5849f4 |
% May 2017
|
|
|
5849f4 |
|
|
|
5849f4 |
# NAME
|
|
|
5849f4 |
storage.conf - Syntax of Container Storage configuration file
|
|
|
5849f4 |
|
|
|
5849f4 |
# DESCRIPTION
|
|
|
5849f4 |
The STORAGE configuration file specifies all of the available container storage options
|
|
|
5849f4 |
for tools using shared container storage, but in a TOML format that can be more easily modified
|
|
|
5849f4 |
and versioned.
|
|
|
5849f4 |
|
|
|
5849f4 |
# FORMAT
|
|
|
5849f4 |
The [TOML format][toml] is used as the encoding of the configuration file.
|
|
|
5849f4 |
Every option and subtable listed here is nested under a global "storage" table.
|
|
|
5849f4 |
No bare options are used. The format of TOML can be simplified to:
|
|
|
5849f4 |
|
|
|
5849f4 |
[table]
|
|
|
5849f4 |
option = value
|
|
|
5849f4 |
|
|
|
5849f4 |
[table.subtable1]
|
|
|
5849f4 |
option = value
|
|
|
5849f4 |
|
|
|
5849f4 |
[table.subtable2]
|
|
|
5849f4 |
option = value
|
|
|
5849f4 |
|
|
|
5849f4 |
## STORAGE TABLE
|
|
|
5849f4 |
|
|
|
5849f4 |
The `storage` table supports the following options:
|
|
|
5849f4 |
|
|
|
5849f4 |
**graphroot**=""
|
|
|
5849f4 |
container storage graph dir (default: "/var/lib/containers/storage")
|
|
|
5849f4 |
Default directory to store all writable content created by container storage programs
|
|
|
5849f4 |
|
|
|
5849f4 |
**runroot**=""
|
|
|
5849f4 |
container storage run dir (default: "/var/run/containers/storage")
|
|
|
5849f4 |
Default directory to store all temporary writable content created by container storage programs
|
|
|
5849f4 |
|
|
|
5849f4 |
**driver**=""
|
|
|
5849f4 |
container storage driver (default is "overlay")
|
|
|
5849f4 |
Default Copy On Write (COW) container storage driver
|
|
|
5849f4 |
|
|
|
5849f4 |
### STORAGE OPTIONS TABLE
|
|
|
5849f4 |
|
|
|
5849f4 |
The `storage.options` table supports the following options:
|
|
|
5849f4 |
|
|
|
5849f4 |
**additionalimagestores**=[]
|
|
|
5849f4 |
Paths to additional container image stores. Usually these are read/only and stored on remote network shares.
|
|
|
5849f4 |
|
|
|
5849f4 |
**size**=""
|
|
|
5849f4 |
Maximum size of a container image. Default is 10GB. This flag can be used to set quota
|
|
|
5849f4 |
on the size of container images.
|
|
|
5849f4 |
|
|
|
5849f4 |
**override_kernel_check**=""
|
|
|
5849f4 |
Tell storage drivers to ignore kernel version checks. Some storage drivers assume that if a kernel is too
|
|
|
5849f4 |
old, the driver is not supported. But for kernels that have had the drivers backported, this flag
|
|
|
5849f4 |
allows users to override the checks
|
|
|
5849f4 |
|
|
|
5849f4 |
# HISTORY
|
|
|
5849f4 |
May 2017, Originally compiled by Dan Walsh <dwalsh@redhat.com>
|
|
|
5849f4 |
Format copied from crio.conf man page created by Aleksa Sarai <asarai@suse.de>
|