Customizing the image |Flatcar Container Linux
Blog
Releases
Docs
FAQ
Security
Flatcar Container Linux
23.10.2025
latest
23.10.2025
Overview
Installing
Overview
Cloud Providers
Overview
Running on Akamai
Running on AWS EC2
Running on Brightbox
Running on Equinix Metal
Running on Microsoft Azure
Running on OpenStack
Running on STACKIT
Running on VMware
Running on Google Compute Engine
Using Google Cloud Launcher
Running on DigitalOcean
Running on Hetzner
Customizing the image
Overview
Customizing a Flatcar image
Virtual Machines
Overview
Running on Hyper-V
Running on KubeVirt
Running on libvirt
Running on QEMU
Running on Vagrant
Running on VirtualBox
Bare Metal
Overview
Booting from an ISO
Booting via iPXE
Booting via PXE
Running on Raspberry Pi 4
Using flatcar-install script
Community supported platforms
Overview
Notes for distributors
Running on a Vultr VPS
Running on Eucalyptus 3.4
Running on Exoscale
Running on OVHcloud
Running on Rackspace
Running on Scaleway
Running on Proxmox VE
Tutorial
Overview
Hands on 1 - Discovering
Overview
Hands on 2 - Provisioning
Overview
Hands on 3 - Deploying
Overview
Hands on 4 - Updating
Overview
Provisioning Tools
Overview
Ignition
Overview
Boot process overview
Network configuration
Specification
Referencing dynamic data
Container Linux Config Transpiler
Overview
Examples
Migrating from cloud-config
Referencing dynamic data
Operator Notes
CL Configuration Specification
Butane Config Transpiler
Overview
Getting Started
Examples
Butane Configuration Specification
Systemd-sysext
Overview
Terraform
Overview
[DEPRECATED / EOL] Torcx
Overview
Metadata and systemd target
Troubleshooting
Nebraska
Overview
Deployment & Authorization
Overview
Managing Flatcar updates
Migrating to older version of Nebraska.
Development
Internationalization
Overview
Contributing
Setup and Operations
Overview
Using Systemd
Overview
Getting Started
Using systemctl
Drop-In Units
Timers
Environment Variables
Using systemd and udev rules
User Units
Common Customizations
Overview
Adding users
Configuring date and time zone
DNS Configuration
Kernel modules and other settings
OverlayBD Artifact Streaming
Using NVIDIA GPUs on Flatcar
Network configuration with networkd
Customizing the etcd unit
Power Management
ACPI
Managing Releases
Overview
Switching release channels
Update and reboot strategies
Verifying Images
update.conf
Storage Setup
Overview
Additional disk space
Configuring RAID
Mounting storage
Configuring iSCSI
Using LVM
Managing swap space
ZFS Extension
Managing Clusters
Overview
Architectures
Cluster discovery
Using AWS ECS
Security Options
Overview
Configuring SSSD
Customizing the SSH daemon
SELinux
Setting up LUKS disk encryption
FIPS mode
Hardening options
Set up audit
Trusted Computing
Custom certificate authorities
Generate self-signed certificates
Disabling SMT
Debugging
Overview
Collecting crash logs
Debugging tools
Reading the system log
Manual version rollbacks
Troubleshooting btrfs
Container Runtimes
Overview
Getting started with Docker
Getting started with Kubernetes
Incus
High Availability Kubernetes
Switching to unified cgroups
Customizing Docker
Authenticating to Container Registries
Migrating from CoreOS
Overview
Updating from CoreOS
Reference
Overview
Constants and IDs
Developer Guides
Overview
Building custom kernel modules
Building production images
Flatcar Container Linux disk layout
Guide to building custom Flatcar images from source
SDK bootstrap process
Tips and tricks
Integrations
Supply chain security mechanisms
How to Contribute
Overview
Docs Style & Formatting
The version of the documentation you are reading is not the latest one! See the
latest version
.
Documentation
23.10.2025
Installing
Customizing the image
23.10.2025
latest
23.10.2025
Customizing the image
This section provides information and guidance on customizing Flatcar images by placing files on the root or OEM filesystem or embedding an Ignition config.
Customizing a Flatcar image