TROUBLESHOOT.md

The boot partition is too small

Upgrades may fail because the boot partition is too small. Indeed the partition layout used is quite stingy. If the overflow is not much, you can re-create the boot partition in-place using smaller inode size like:

cp -a /boot /var
umount /boot /sysroot/boot
mkfs.ext2 -L /boot -I 128 /dev/vda1
mount /boot
cp -a /var/boot/* /boot

Which will use inodes of 128 bytes.

Upgrade failed, a re-deployment is required

Make sure to pass the specific partition ID and options to the deploy command:

ostree admin deploy --os=pine trunk \
            --karg=root=UUID=$(blkid -s UUID -o value /dev/vda3) \
            --karg=rootfstype=xfs \
            --karg=rootflags=rw,noatime,nodiratime,largeio,inode64