Go to file
Bruce Ashfield c625a5bf7b vdkr-init: improve Docker daemon startup logging and error handling
Improve debugging capabilities when Docker daemon fails to start:
- Log dockerd output to /var/log/docker.log instead of /dev/null
- Capture docker info exit code and output for diagnostics
- Show docker info error on every 10th iteration while waiting
- Include last docker info output and docker.log tail on failure
- Extend sleep on failure from 2s to 5s for log review

Signed-off-by: Bruce Ashfield <bruce.ashfield@gmail.com>
2026-01-24 15:53:46 -05:00
classes vcontainer: add sanity checks and auto-enable virtfs for QEMU 2026-01-23 22:29:11 -05:00
conf vcontainer: add sanity checks and auto-enable virtfs for QEMU 2026-01-23 22:29:11 -05:00
docs image-oci: add layer caching for multi-layer OCI builds 2026-01-21 18:00:26 -05:00
dynamic-layers kernel: drop 6.6 support 2025-02-11 23:19:51 +00:00
files fs-perms-nagios.txt: add perms conf file 2018-09-06 12:45:17 -04:00
lib/oeqa/runtime/cases xtf: add testimage integration to run XTF test cases in OEQA 2021-09-02 16:36:23 -04:00
recipes-containers vdkr-init: improve Docker daemon startup logging and error handling 2026-01-24 15:53:46 -05:00
recipes-core packagegroups: add container build aggregates 2026-01-24 15:53:46 -05:00
recipes-demo image-oci: add multi-layer OCI image support with OCI_LAYERS 2026-01-21 18:00:26 -05:00
recipes-devtools vcontainer: add sanity checks and auto-enable virtfs for QEMU 2026-01-23 22:29:11 -05:00
recipes-extended container-bundles: add multilayer container bundle recipe 2026-01-21 18:00:26 -05:00
recipes-graphics/xorg-xserver global: overrides syntax conversion 2021-08-02 17:17:53 -04:00
recipes-kernel linux-yocto: add iptables legacy kernel config for Docker 2026-01-23 22:29:11 -05:00
recipes-networking cni: regenerate go-mod/shallow/hybrid 2026-01-04 11:47:30 -05:00
scripts go-mod-fetcher: fix shallow clone handling, duplicates, and discovery workflow 2026-01-04 11:40:15 -05:00
tests vcontainer: add multi-arch OCI support 2026-01-21 18:00:26 -05:00
wic xen: use bzImage for boot (instead of vmlinux) 2024-03-21 23:15:13 +00:00
.gitignore buildah: add seccomp and ipv6 to REQUIRED_DISTRO_FEATURES 2023-04-12 13:10:11 -04:00
COPYING.MIT Initial meta-xen layer documentation. 2012-06-21 15:51:11 -06:00
MAINTAINERS MAINTAINERS: add xtf and the raspberry pi dynamic layer for Xen 2021-12-16 21:45:00 -05:00
meta-virt-roadmap.txt docs: update meta-virt-roadmap 2026-01-21 18:00:26 -05:00
README.md vcontainer: add documentation 2026-01-21 18:00:26 -05:00
SECURITY.md docs: add SECURITY.md and rename README.md 2023-11-06 16:21:12 +00:00

meta-virtualization

The meta-virtualization layer is the authoritative resource for virtualization technologies in OpenEmbedded / Yocto built distributions. It provides support or both hypervisor-based virtualization (such as KVM, Xen, and QEMU) and system-level virtualization (Linux containers), along with the host and guest technologies required to build complete solutions ranging from embedded systems to full deep CNCF stack deployments.

The bbappend files for some recipes (e.g. linux-yocto) in this layer need to have 'virtualization' in DISTRO_FEATURES to have effect. To enable them, add in configuration file the following line.

DISTRO_FEATURES:append = " virtualization"

If meta-virtualization is included, but virtualization is not enabled as a distro feature a warning is printed at parse time:

You have included the meta-virtualization layer, but
'virtualization' has not been enabled in your DISTRO_FEATURES. Some bbappend files
may not take effect. See the meta-virtualization README for details on enabling
virtualization support.

If you know what you are doing, this warning can be disabled by setting the following variable in your configuration:

SKIP_META_VIRT_SANITY_CHECK = 1

Depending on your use case, there are other distro features in meta-virtualization that may also be enabled:

  • xen: enables xen functionality in various packages (kernel, libvirt, etc)
  • kvm: enables KVM configurations in the kernel and autoloads modules
  • k8s: enables kubernetes configurations in the kernel, tools and configuration
  • aufs: enables aufs support in docker and linux-yocto
  • x11: enable xen and libvirt functionality related to x11
  • selinux: enables functionality in libvirt and lxc
  • systemd: enable systemd services and unit files (for recipes for support)
  • sysvinit: enable sysvinit scripts (for recipes with support)
  • seccomp: enable seccomp support for packages that have the capability.
  • vcontainer: enables vdkr/vpdmn virtual container runtime support, including kernel config fragments (9p, squashfs, overlayfs) and busybox utilities (base64, hexdump) required for container cross-install during image builds.

Dependencies

This layer depends on:

URI: git://github.com/openembedded/openembedded-core.git branch: master revision: HEAD prio: default

URI: git://github.com/openembedded/meta-openembedded.git branch: master revision: HEAD layers: meta-oe meta-networking meta-filesystems meta-python

Required for Xen XSM policy: URI: git://git.yoctoproject.org/meta-selinux branch: master revision: HEAD prio: default

Required for Ceph: URI: git://git.yoctoproject.org/meta-cloud-services branch: master revision: HEAD prio: default

Required for cri-o: URI: git://git.yoctoproject.org/meta-selinux branch: master revision: HEAD prio: default

Community / Collaboration

Repository: https://git.yoctoproject.org/cgit/cgit.cgi/meta-virtualization/ Mailing list: https://lists.yoctoproject.org/g/meta-virtualization IRC: libera.chat #meta-virt channel

Maintenance

Send pull requests, patches, comments or questions to meta-virtualization@lists.yoctoproject.org

Maintainer: Bruce Ashfield bruce.ashfield@gmail.com see MAINTAINERS for more specific information

When sending single patches, please using something like: $ git send-email -1 -M --to meta-virtualization@lists.yoctoproject.org --subject-prefix='meta-virtualization][PATCH'

License

All metadata is MIT licensed unless otherwise stated. Source code included in tree for individual recipes is under the LICENSE stated in each recipe (.bb file) unless otherwise stated.