RancherOS is a minimal Linux distribution designed to run the entire operating system as Docker containers. Written primarily in Go, it represents a radical approach to OS design where system services such as udev and rsyslog run as containers managed by Docker, rather than as traditional processes. The distribution includes only the bare minimum software needed to execute Docker, keeping the binary download extremely small while allowing all other functionality to be pulled in dynamically through containers.
The architecture accomplishes this containerized approach through a dual-Docker design. The system launches two instances of Docker: a system Docker that runs as the first process, and a user Docker that runs within a container managed by system Docker. This separation was implemented both for logical organization and as a safety mechanism, preventing accidental deletion of the entire OS if someone executed commands like docker rm -f $(docker ps -qa) on the user Docker instance.
The latest stable release is version 1.5.8, which bundles Docker 19.03.15 and Linux kernel 4.14.138. RancherOS provides extensive deployment flexibility through multiple ISO formats and cloud images. The distribution offers standard ISO downloads alongside specialized variants for hypervisors including VMware, Hyper-V, and Proxmox VE. It also provides pre-built images for major cloud platforms including Amazon EC2 across multiple regions, DigitalOcean, OpenStack, CloudStack, Aliyun, and Google Compute Engine. Additionally, RancherOS supports both AMD64 and ARM64 architectures, with specific builds available for Raspberry Pi 64-bit systems. The project includes iPXE boot support and provides raw filesystem archives for custom deployment scenarios.
However, RancherOS 1.x is no longer actively maintained. The README explicitly states that development has ceased due to two primary factors. First, the container runtime landscape has evolved significantly, with containerd and CRIO emerging as industry standards alongside or instead of Docker Engine. RancherOS was specifically designed around Docker Engine only, and its current architecture does not accommodate this shift toward alternative container runtimes. Second, RancherOS was built as a minimalistic OS for purpose-built containerized applications rather than as a general-purpose operating system like CentOS or Ubuntu. This design decision meant that independent software vendors have not certified their software to run on RancherOS, and the distribution lacks necessary components for many traditional applications.
The project documentation is hosted at rancher.com/docs/os/v1.x/en/ and provides detailed information on installation, configuration, and operation. Community support is available through Rancher forums and IRC channels. Security issues should be reported to [email protected] rather than through public GitHub issues. The codebase is licensed under the Apache License 2.0 and is maintained by Rancher Labs, Inc. While RancherOS 1.x itself is no longer under active development, Rancher has indicated that a replacement product is in development.
