Switching release channels¶
Flatcar Container Linux is designed to be updated automatically with different schedules per channel. You can disable this feature, although we don't recommend it. Read the release notes for specific features and bug fixes.
By design, the Flatcar Container Linux update engine does not execute downgrades. If you're switching from a channel with a higher Flatcar Container Linux version than the new channel, your machine won't be updated again until the new channel contains a higher version number.
Customizing channel configuration¶
The update engine sources its configuration from
The former file contains the default hardcoded configuration from the running OS version. Its values cannot be edited, but they can be overridden by the ones in the latter file.
To switch a machine to a different channel, specify the new channel group in
In order for the configuration override to take effect, the update engine must first be restarted:
sudo systemctl restart update-engine
After the update engine is restarted, the machine should check for an update within an hour.
The live status of updates checking can queried via:
The update engine logs all update attempts, which can inspected in the system journal:
journalctl -f -u update-engine
For reference, the OS version and channel for a running system can be determined via:
cat /usr/share/flatcar/os-release cat /usr/share/flatcar/update.conf
Note: while a manual channel switch is in progress,
/usr/share/flatcar/update.conf shows the channel for the current OS while
/etc/flatcar/update.conf shows the one for the next update.