crun(1)                     General Commands Manual                    crun(1)



<?><?><?> (NAME)
       krun - <?><?><?><?> <?><?><?><?><?> OCI <?><?><?><?><?> <?><?> crun
       <?><?> <?><?><?><?><?><?><?> <?><?> libkrun <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> KVM



<?><?><?><?><?> <?><?><?><?><?> (SYNOPSIS)
       krun [global options] command [command options] [arguments...]



<?><?><?><?><?><?><?> (DESCRIPTION)
       <?><?><?><?><?> krun <?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?> crun <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?> <?><?> <?><?> <?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?> (OCI) <?><?><?><?><?>
       <?><?><?><?><?><?><?>. <?><?><?><?><?> krun <?><?> <?><?><?><?><?>
       <?><?><?><?><?><?> (Symlink) <?><?> <?><?><?><?> <?><?><?><?><?><?>
       crun <?><?><?> <?><?> <?><?> crun <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?> <?><?><?><?> krun <?><?><?><?> <?><?><?>.


       <?><?><?><?><?> krun <?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?>
       libkrun <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?><?> <?><?>
       <?><?> <?><?><?><?> <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?>
       <?><?> <?><?><?><?><?><?><?><?><?><?> KVM <?><?><?><?>
       <?><?><?><?><?><?>.


       <?><?><?><?><?><?><?><?> libkrun <?><?> VMM (<?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?> <?><?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>) <?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?><?> <?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> <?>
       <?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?> <?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?>.


       <?><?> <?><?><?><?> <?><?><?> <?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?><?><?>
       <?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?> <?>
       <?><?><?><?><?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?><?> <?><?>
       <?><?><?><?><?> <?><?><?><?><?> krun <?><?><?><?><?><?><?> <?><?><?>.



<?><?><?><?><?><?><?><?> (CONFIGURATION)
       <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?> (microVM)
       <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> OCI <?><?> <?><?>
       <?><?><?><?> .krun_vm.json <?><?><?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
       <?><?><?>. <?><?><?><?><?> <?><?> <?><?> <?><?> <?><?><?><?>
       <?><?><?><?><?> <?><?><?><?><?><?>
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> OCI <?><?><?><?><?><?>
       <?><?><?><?><?>.


   <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> OCI (OCI Annotations)
       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> OCI
       <?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?> <?><?><?><?><?>
       <?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>. <?><?>
       <?><?><?><?><?> <?><?><?><?> <?><?> podman:

       podman run --runtime=krun --annotation krun.nested_virt=1 ...


       <?><?><?><?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?>
       <?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>:

       krun.cpus=NUM
              <?><?><?><?><?> vCPU<?><?> <?><?><?><?> microVM
              (<?><?><?><?><?><?> <?><?>). <?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?>
              <?><?> <?><?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> (CPU affinity) <?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?>.


       krun.ram_mib=NUM
              <?><?><?><?><?> <?><?><?><?><?> RAM <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> (MiB) <?><?><?><?> microVM.
              <?><?><?><?><?><?> <?><?><?><?> <?><?> <?><?><?>
              <?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?>
              <?><?><?><?><?><?><?>. <?><?> <?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?> OCI (<?><?> <?><?><?><?>
              <?><?><?><?>) <?><?> <?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?> <?><?><?><?><?><?>.


       krun.gpu_flags=FLAGS
              <?><?><?><?><?><?><?><?><?> virtio-gpu <?><?>
              <?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?> virgl.
              <?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              /dev/dri <?><?><?>. <?><?><?><?><?><?> <?><?> FLAGS <?><?><?><?>
              VIRGLRENDERER_RENDER_SERVER <?><?><?><?><?> <?><?><?><?>
              /usr/libexec/virgl_render_server <?><?><?> <?><?>
              <?><?><?><?><?> <?><?><?><?>.


       krun.use_passt=NUM
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> 0 <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?> passt <?><?>
              <?><?> microVM <?><?><?><?> <?><?><?><?><?><?>.


       krun.nested_virt=NUM
              <?><?><?><?><?><?> <?><?> <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?> 0 <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> (Nested
              Virtualization) <?><?> <?><?> microVM <?><?><?><?> <?><?><?><?>
              <?> <?><?><?><?><?><?><?><?> <?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?><?><?><?>
              (VMX <?><?> Intel <?> SVM <?><?> AMD) <?><?> <?><?>
              <?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?>. <?><?><?> <?><?><?><?><?><?>
              <?><?><?><?><?><?><?> <?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?> <?><?><?>
              <?><?><?><?><?><?> <?><?><?> (<?><?><?><?><?>
              /sys/module/kvm_intel/parameters/nested <?><?>
              /sys/module/kvm_amd/parameters/nested <?><?><?><?>
              <?><?><?><?><?> Y <?><?> 1 <?><?> <?><?><?><?><?> <?><?><?><?>).
              <?><?> <?><?><?><?><?> <?><?> <?><?> <?><?><?> <?><?><?><?>
              <?><?><?><?><?><?> <?><?> <?><?><?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?> <?><?><?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?> <?><?> <?><?><?><?><?> <?><?><?><?>
              <?><?><?><?><?><?>.


       krun.variant=VARIANT
              <?><?><?><?><?><?> <?><?> <?><?><?><?> (Variant)
              <?><?><?><?><?><?><?> <?><?> libkrun. <?><?><?><?><?><?>
              <?><?><?><?><?><?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
              <?><?> sev (<?><?><?> <?><?><?><?> <?><?><?><?><?><?><?> AMD
              SEV) <?> aws-nitro (<?><?><?><?><?><?><?><?> <?><?><?><?><?><?>
              AWS Nitro Enclaves).


   <?><?><?><?> <?><?><?><?><?><?><?><?> <?><?><?><?><?> <?><?><?><?><?> (VM
       Configuration File)
       <?><?> <?><?><?><?> .krun_vm.json <?><?><?><?><?><?><?><?> <?><?>
       <?><?><?><?> <?><?><?><?><?> <?><?><?><?><?><?><?> <?><?><?><?>
       <?><?><?><?> <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?> VM
       <?><?> <?><?><?><?><?> <?><?><?>. <?><?><?> <?><?><?><?> <?><?>
       <?><?><?> JSON <?><?> <?><?><?><?><?><?><?> <?><?><?><?><?><?><?>
       <?><?><?> <?><?><?>:

       o cpus (<?><?><?> <?><?><?><?>): <?><?><?><?><?>
         <?><?><?><?><?><?><?><?><?><?><?> krun.cpus.

       o ram_mib (<?><?><?> <?><?><?><?>): <?><?><?><?><?>
         <?><?><?><?><?><?><?><?><?><?><?> krun.ram_mib.

       o gpu_flags (<?><?><?> <?><?><?><?>): <?><?><?><?><?>
         <?><?><?><?><?><?><?><?><?><?><?> krun.gpu_flags.

       o use_passt (<?><?><?> <?><?><?><?>): <?><?><?><?><?>
         <?><?><?><?><?><?><?><?><?><?><?> krun.use_passt.

       o nested_virt (<?><?><?> <?><?><?><?>): <?><?><?><?><?>
         <?><?><?><?><?><?><?><?><?><?><?> krun.nested_virt.

       o flavor (<?><?><?><?>): <?><?><?><?><?>
         <?><?><?><?><?><?><?><?><?><?><?> krun.variant.

       o kernel_path (<?><?><?><?>): <?><?><?><?> <?><?><?><?>
         <?><?><?><?><?>.

       o kernel_format (<?><?><?> <?><?><?><?>): <?><?><?><?><?> <?><?><?><?>
         <?><?><?><?>.

       o initrd_path (<?><?><?><?>): <?><?><?><?> <?><?><?><?><?> initrd.

       o kernel_cmdline (<?><?><?><?>): <?><?> <?><?><?><?><?> <?><?><?><?>.

       o virtiofs_tag (<?><?><?><?>): <?><?><?><?><?> VirtioFS
         (<?><?><?><?><?><?><?>: /dev/root).

       o virtiofs_shm_size (<?><?><?> <?><?><?><?>): <?><?><?><?><?><?>
         <?><?><?><?><?> <?><?><?><?><?> VirtioFS DAX <?><?> <?><?><?>
         <?><?><?><?> (<?><?><?><?><?><?><?>: <?><?><?>
         <?><?><?><?><?><?><?><?>).


       <?><?><?><?>:

       {"nested_virt": 1, "cpus": 4, "ram_mib": 2048}



<?><?><?><?><?><?><?> (COMMANDS)
       <?><?><?><?> <?><?><?><?><?><?> <?><?><?><?><?><?><?> <?><?>
       <?><?><?><?><?> krun <?><?> <?><?><?><?> <?><?><?><?><?><?><?> crun(1)
       <?><?><?><?><?><?> <?><?><?><?>.



<?><?><?><?><?><?> <?><?><?><?><?><?> (SEE ALSO)
       crun(1)

                                 User Commands                         crun(1)