Part I. The Transactional Update Guide

Thorsten Kukuk

Ignaz Forster

Version 0.4, 28. September 2021

This is the documentation for transactional-update and is intended for users, administrators and packagers.

It describes how transactional-update with Btrfs works by giving an overview of the design, what an administrator needs to know about setting up and operating such a system and what a packager needs to know for creating compatible packages.

For specific usage see the transactional-update man page or the list of Kubic related commands.

Table of Contents

Introduction
Description
Definition
Use Cases
Components
libtukit.so
tukit
D-Bus Bindings
transactional-update
High Level Concept
The root file system
Updating the correct snapshot
Workflow
Simplified workflow
System setup
Read-only file system
/var
/etc
Files
Porting to other systems
Author/acknowledgments
Copyright information for this document