Chapter 4. Configuring CodeReady Containers
4.1. About CodeReady Containers configuration
Use the crc config
command to configure both the crc
executable and the CodeReady Containers virtual machine. The crc config
command requires a subcommand to act on the configuration. The available subcommands are get
, set,
unset
, and view
. The get
, set
, and unset
subcommands operate on named configurable properties. Run the crc config --help
command to list the available properties.
You can also use the crc config
command to configure the behavior of the startup checks for the crc start
and crc setup
commands. By default, startup checks report an error and stop execution when their conditions are not met. Set the value of a property starting with skip-check
to true
to skip the check.
4.2. Viewing CodeReady Containers configuration
The CodeReady Containers executable provides commands to view configurable properties and the current CodeReady Containers configuration.
Procedure
To view the available configurable properties:
$ crc config --help
To view the values for a configurable property:
$ crc config get <property>
To view the complete current configuration:
$ crc config view
NoteThe
crc config view
command does not return any information if the configuration consists of default values.
4.3. Configuring the virtual machine
Use the cpus
and memory
properties to configure the default number of vCPUs and amount of memory available to the CodeReady Containers virtual machine, respectively.
Alternatively, the number of vCPUs and amount of memory can be assigned using the --cpus
and --memory
flags to the crc start
command, respectively.
You cannot change the configuration of a running CodeReady Containers virtual machine. To enable configuration changes, you must stop the running virtual machine and start it again.
Procedure
To configure the number of vCPUs available to the virtual machine:
$ crc config set cpus <number>
The default value for the
cpus
property is4
. The number of vCPUs to assign must be greater than or equal to the default.To start the virtual machine with the desired number of vCPUs:
$ crc start --cpus <number>
To configure the memory available to the virtual machine:
$ crc config set memory <number-in-mib>
NoteValues for available memory are set in mebibytes (MiB). One gibibyte (GiB) of memory is equal to 1024 MiB.
The default value for the
memory
property is9216
. The amount of memory to assign must be greater than or equal to the default.To start the virtual machine with the desired amount of memory:
$ crc start --memory <number-in-mib>