1KRUNVM(1)                                                            KRUNVM(1)
2
3
4

NAME

6       krunvm - Create microVMs from OCI images
7

SYNOPSIS

9       krunvm [GLOBAL_OPTIONS] command
10

DESCRIPTION

12       krunvm is a CLI utility to create, manage and start microVMs which are
13       generated from OCI images, providing an interface that resembles
14       operating on conventional containers.
15
16       krunvm uses buildah(1) to download the OCI image and mount it into a
17       local directory, and libkrun to launch the microVM.
18
19       The local directory where the OCI image has been mounted is used as the
20       root filesystem for the microVM, serviced by a virtio-fs device/server
21       bundled into libkrun.
22
23       krunvm supports mounting additional local directories into the microVM
24       and exposing ports from the guest to the host (and the networks
25       connected to it).
26
27       Networking to the guest running in the microVM is provided by libkrun’s
28       TSI (Transparent Socket Impersonation), enabling a seamless experience
29       that doesn’t require network bridges nor other explicit network
30       configuration.
31

GLOBAL OPTIONS

33       -v NUM
34           Sets the verbosity level, from the lowest (0) to the highest (5).
35

COMMANDS

37       ┌───────────────────┬────────────────────────────┐
38       │                   │                            │
39       │Command            │ Description                │
40       ├───────────────────┼────────────────────────────┤
41       │                   │                            │
42       │krunvm-changevm(1) │ Change the configuration   │
43       │                   │ of a microVM               │
44       ├───────────────────┼────────────────────────────┤
45       │                   │                            │
46       │krunvm-config(1)   │ Configure global values    │
47       ├───────────────────┼────────────────────────────┤
48       │                   │                            │
49       │krunvm-create(1)   │ Create a new microVM       │
50       ├───────────────────┼────────────────────────────┤
51       │                   │                            │
52       │krunvm-delete(1)   │ Delete an existing microVM │
53       ├───────────────────┼────────────────────────────┤
54       │                   │                            │
55       │krunvm-list(1)     │ List the existing microVMs │
56       ├───────────────────┼────────────────────────────┤
57       │                   │                            │
58       │krunvm-start(1)    │ Start an existing microVM  │
59       └───────────────────┴────────────────────────────┘
60

SEE ALSO

62       buildah(1)
63
64
65
66                                  2023-08-07                         KRUNVM(1)