Flatcar Linux Documentation

Welcome to Flatcar Linux documentation

Getting Started

Flatcar Linux runs on most cloud providers, virtualization platforms and bare metal servers. Running a local VM on your laptop is a great dev environment. Following the Quick Start guide is the fastest way to get set up.

Provisioning Cloud Providers
Using Container Linux Config Amazon EC2
Using Config Transpiler DigitalOcean
CL Config Dynamic Data Google Compute Engine
CL Config Examples Microsoft Azure
CL Config Spec QEMU
Bare Metal Upgrading from Container Linux
Using Matchbox Migrate from Container Linux
Booting with iPXE Update from Container Linux directly.
Booting with PXE
Installing to Disk
Booting from ISO
Root filesystem placement

Working with Clusters

Follow these guides to connect your machines together as a cluster. Configure machine parameters, create users, inject multiple SSH keys, and more with Container Linux Config.

Creating Clusters Customizing Clusters
Cluster architectures Using networkd to customize networking
Update strategies Using systemd drop-in units
Clustering machines Using environment variables in systemd units
Verify Flatcar Linux Images with GPG Configuring DNS
Configuring date & timezone
Adding users
Kernel modules / sysctl parameters
Managing Clusters Scaling Clusters
Registry authentication Adding disk space
iSCSI configuration Mounting storage
Adding swap Power management
Amazon EC2 Container Service
Using systemd to manage Docker containers
Using systemd and udev rules
Switching release channels
Scheduling tasks with systemd
Securing Clusters Debugging Clusters
Customizing the SSH daemon Install debugging tools
Configuring SSSD on Flatcar Linux Working with btrfs
Hardening a Flatcar Linux machine Reading the system log
Trusted Computing Hardware Requirements Collecting crash logs
Adding Cert Authorities Manual Flatcar Linux rollbacks
Using SELinux
Disabling SMT

Container Runtimes

Flatcar Linux supports all of the popular methods for running containers, and you can choose to interact with the containers at a low-level, or use a higher level orchestration framework. Listed below are your options from the highest level abstraction down to the lowest level, the container runtime.

Docker rkt
Getting started with Docker Getting started with rkt
Customizing Docker


APIs and troubleshooting guides for working with Flatcar Linux.

Developer guides


Migrating from cloud-config to Container Linux Config