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