kata-containers /kata-containers
Kata Containers is an open source project and community working to build a standard implementation of lightweight Virtual Machines (VMs) that feel and perform like containers, but provide the workload isolation and security advantages of VMs. https://katacontainers.io/
★ 9,154⑂ 1,552👁 100⑃ 8,053● 6,283▤ 124
+7
Daily
9,154
stars
1,552
forks
100
watchers
8,053
prs
6,283
issues
124
releases
README
Kata Containers
Welcome to Kata Containers!
This repository is the home of the Kata Containers code for the 2.0 and newer
releases.
If you want to learn about Kata Containers, visit the main
Kata Containers website.
Introduction
Kata Containers is an open source project and community working to build a
standard implementation of lightweight Virtual Machines (VMs) that feel and
perform like containers, but provide the workload isolation and security
advantages of VMs.
License
The code is licensed under the Apache 2.0 license.
See the license file for further details.
Platform support
Kata Containers currently runs on 64-bit systems supporting the following
technologies:
| Architecture | Virtualization technology |
|-|-|
| x86_64, amd64 | Intel VT-x, AMD SVM |
| aarch64 ("arm64")| ARM Hyp |
| ppc64le | IBM Power |
| s390x | IBM Z & LinuxONE SIE |
Hardware requirements
The Kata Containers runtime provides a command to
determine if your host system is capable of running and creating a
Kata Container:
bash
$ kata-runtime check
Notes:
- This command runs a number of checks including connecting to the
network to determine if a newer release of Kata Containers is
available on GitHub. If you do not wish this to check to run, add
the --no-network-checks option.
- By default, only a brief success / failure message is printed.
If more details are needed, the --verbose flag can be used to display the
list of all the checks performed.
- If the command is run as the root user additional checks are
run (including checking if another incompatible hypervisor is running).
When running as root, network checks are automatically disabled.
Getting started
New to Kata Containers? Start with the
Quick Start Guide to learn the basics and run your
first workload, then see the installation guide.
Documentation
See the official documentation including:
- Installation guide
- Developer guide
- Design documents
- Architecture overview
- Architecture 4.0 overview
Configuration
Kata Containers uses a single
configuration file
which contains a number of sections for various parts of the Kata
Containers system including the runtime, the
agent and the hypervisor.
Hypervisors
See the hypervisors document and the
Hypervisor specific configuration details.
Community
To learn more about the project, its community and governance, see the
community repository. This is
the first place to go if you wish to contribute to the project.
Getting help
See the community section for ways to contact us.
Raising issues
Please raise an issue
in this repository.
Note:
If you are reporting a security issue, please follow the vulnerability reporting process
Developers
See the developer guide.
Components
Main components
The table below lists the core parts of the project:
| Component | Type | Description |
|-|-|-|
| runtime | core | Main component run by a container manager and providing a containerd shimv2 runtime impleTop issues
#13561runtime: a hugepage-backed guest ignores the pod's hugepage declaration33 comments · 2026-08-07#11532rfc: loose coupling of agent and guest components a.k.a. the Kata/CoCo interface26 comments · 2025-07-07#1693Add kubernetes CRI Port-Forward support25 comments · 2018-09-04#13738RFC : Passing unmeasured inputs to Coco Guest components24 comments · 2026-08-27#12703[Bug] `kata-qemu-nvidia-gpu-snp` runtime fails to start container with B200 GPU passthrough24 comments · 2026-03-23#8521kata containers on Raspberry Pi 424 comments · 2023-11-26#8170support user namespace22 comments · 2023-10-08#2580no network interface created when use ctr to launch the container22 comments · 2021-09-06
Discussions
#13325v4 timeline1 comments · 2026-07-03#13259Is it possible to run podman inside Kata Containers on k3s?2 comments · 2026-06-22#13224Can Kata-agent parse guest CDI in VM to inject one or more GPUs in containers?1 comments · 2026-06-15#12976Ram usage of the `quay.io/kata-containers/kata-deploy` image from the DaemonSet3 comments · 2026-05-04#12745[Feature Request] Add "enabled" switch for RuntimeClass overhead in Helm Chart to support custom metering strategies2 comments · 2026-03-27#12451FreeBSD support1 comments · 2026-02-04#11961GitHub Large PR Checks Pane: a tool to display more tests in the PR checks pane0 comments · 2025-10-22#11733ARM64 NPU Pass-Through in Kata: Anyone Tried Ascend 910 on openEuler?0 comments · 2025-08-29
Latest release
Kata Containers 4.3.1 4.3.1 2026-10-21Survey Please take the Kata Containers survey: - https://openinfrafoundation.formstack.com/forms/kata_containers_user_survey This will help the Kata Containers community understand: - how you use Kata Containers - what features and improvements you would like to see in Kata Containers Libseccomp Notices The kata-agent binaries inside the Kata Containers images provided with this release are statically linked with the following [GNU LGPL-2.1][lgpl-2.1] licensed libseccomp library. [libseccomp][libseccomp] The kata-agent uses the libseccomp v2.6.0 which is not modified from the upstream