bottlerocket-os /bottlerocket
An operating system designed for hosting containers
★ 9,704⑂ 588👁 122⑃ 2,994● 1,639▤ 139
+0
Daily
9,704
stars
588
forks
122
watchers
2,994
prs
1,639
issues
139
releases
README
Bottlerocket OS Welcome to Bottlerocket! Bottlerocket is a free and open-source Linux-based operating system meant for hosting containers. To learn more about Bottlerocket, visit the official Bottlerocket website and documentation. Otherwise, if you’re ready to jump right in, read one of our setup guides for running Bottlerocket in Amazon EKS, Amazon ECS, or VMware. If you're interested in running Bottlerocket on bare metal servers, please refer to the provisioning guide to get started. Bottlerocket focuses on security and maintainability, providing a reliable, consistent, and safe platform for container-based workloads. This is a reflection of what we've learned building operating systems and services at Amazon. You can read more about what drives us in our charter. The base operating system has just what you need to run containers reliably, and is built with standard open-source components. Bottlerocket-specific additions focus on reliable updates and on the API. Instead of making configuration changes manually, you can change settings with an API call, and these changes are automatically migrated through updates. Some notable features include: API access for configuring your system, with secure out-of-band access methods when you need them. Updates based on partition flips, for fast and reliable system updates. Modeled configuration that's automatically migrated through updates. Security as a top priority. Participate in the Community There are many ways to take part in the Bottlerocket community: - Join us on Meetup to hear about the latest Bottlerocket (virtual/in-person) events and community meetings. Community meetings are typically every other week. Details can be found under the Events section on Meetup, and you will receive email notifications if you become a member of the Meetup group. (It's free to join!) - Start or join a discussion if you have questions about Bottlerocket. - If you're interested in contributing, thank you! Please see our contributor's guide. Contact us If you find a security issue, please contact our security team rather than opening an issue. We use GitHub issues to track other bug reports and feature requests. You can look at existing issues to see whether your concern is already known. If not, you can select from a few templates and get some guidance on the type of information that would be most helpful. Contact us with a new issue here. We don't have other communication channels set up quite yet, but don't worry about making an issue or a discussion thread! You can let us know about things that seem difficult, or even ways you might like to help. Variants To start, we're focusing on the use of Bottlerocket as a host OS in AWS EKS Kubernetes clusters and Amazon ECS clusters. We’re excited to get early feedback and to continue working on more use cases! Bottlerocket is architected such that different cloud environments and container orchestrators can be supported in the future. A b
Top issues
#4075Unresponsive/unreachable Bottlerocket EKS nodes49 comments · 2024-06-26#1721Decouple MaxPods from CNI Logic47 comments · 2021-08-22#3631Bottlerocket ignoring settings.container-registry.mirrors22 comments · 2023-11-30#3064Bottlerocket fails to find DNS name in private subnet22 comments · 2023-05-01#3732NodePort services inaccessible/blocked by iptables21 comments · 2024-01-25#3726Bottlerocket node intermittently fails to start with "[FAILED] Failed to start Wait for Network to be Configured."18 comments · 2024-01-23#2352Occasional "exec format error"17 comments · 2022-08-16#3341Configurable MTU16 comments · 2023-08-11
Discussions
#4986eMudhra CA distrust discussion3 comments · 2026-10-26#4972Superpowered bootstrap containers.1 comments · 2026-10-16#4970How to Prevent ASG Instance from Becoming InService Until Orchestrator is "Ready"?1 comments · 2026-10-15#4884can I use it without eks or ecs。I am using in kvm,can not find the img or iso file?2 comments · 2026-07-13#4852CIFSwitch Impact and Mitigation Discussion1 comments · 2026-06-01#4833Security Response Question2 comments · 2026-05-08#4829Getting application-inventory.json or similar without booting AMI1 comments · 2026-05-06#4806Missing kernel source files0 comments · 2026-04-10
Latest release
v1.69.0 v1.69.0 2026-11-10Release Highlights Use containerd 2.3 in all variants ([4989]) Add the opt-in dranet DRA networking driver to Kubernetes 1.34 through 1.37 NVIDIA variants ([4974]) OS Changes Update bottlerocket-kernel-kit from 9.6.2 to 9.7.0 ([5002]) Update bottlerocket-core-kit from 17.4.0 to 18.0.0 ([5002]) Update admin-container from 0.21.6 to 0.21.7 CHANGELOG (commits) ([4996]) Update control-container from 0.21.6 to 0.21.7 CHANGELOG (commits) ([4996]) Update bootstrap-container from 0.3.6 to 0.3.7 CHANGELOG (commits) ([4996]) Add settings.kernel.zram.size to configure the boot-time zr