krunvm-changevm - Man Page

Change the configuration of a microVM

Synopsis

krunvm changevm [Options] microVM

Description

krunvm changevm changes the configuration of an existing microVM.

When run without any Options, it displays the current configuration of the microVM.

Options

--remove-ports

Removes all port mappings.

--remote-volumes

Removes all volume mappings.

--cpus NUM

Changes the number of vCPUs that will be created for this microVM.

--mem NUM

Changes the amount of RAM, in MiB, that will be available to this microVM.

The memory configured for the microVM will not be reserved immediately. Instead, it will be provided as the guest demands it, and both the guest and libkrun (acting as the Virtual Machine Monitor) will attempt to return as many pages as possible to the host.

--name NAME

Assigns a new name to the microVM.

-p,  --port HOST_PORT:GUEST_PORT

Exposes a port in the guest running in the microVM through a port in the host.

This option can be specified multiple times to expose as many guest ports as desired.

-v,  --volume HOST_PATH:GUEST_PATH

Makes HOST_PATH visible in the guest running in the microVM through GUEST_PATH.

This option can be specified multiple times to make more paths in the host visible in the guest.

-w,  --workdir GUEST_PATH

Configures GUEST_PATH as the working directory for the first binary executed in the microVM.

See Also

krunvm(1), krunvm-create(1)

Referenced By

krunvm(1), krunvm-create(1), krunvm-start(1).

2022-07-18