Skip to content

container.md

Latest commit

 

History

History
28 lines (19 loc) · 807 Bytes

container.md

File metadata and controls

28 lines (19 loc) · 807 Bytes

Container format

The container must contain one of these files in order to boot the VM.

  1. /boot/vmlinux
  2. /boot/vmlinuz

The first existing file is used.

Other files and directories in the container are merged with the host filesystem using an overlayfs mount inside the VM.

Error: directory /lib: shadows symlink on host

This error is generated if the image contains a directory that would shadow important directories in the host:

  • /lib
  • /lib64
  • /bin
  • /sbin

This happens when running on distributions that have completed a /usr merge. In this case these directories are symlinks on the host. Overlaying a directory from the image will make the symlink disappear.

To work around the issue, place files in /usr/lib, ... and include your own /lib -> /usr/lib symlink in the image.