Could not mount Btrfs subvolume '/@/snapshots'
0 reputation · 20 Aug 2026, 05:10 UTC
0 reputation · 20 Aug 2026, 05:10 UTC
The deployment process halts when encountering the specific error string 'Could not mount Btrfs subvolume '/@/snapshots' on openSUSE.
This failure points directly to the snapper component's inability to manage Btrfs subvolume snapshots during the installation phase.
Given the version dependency in openSUSE Leap 15.5 regarding the 'ROLLBACK_ON_TRANSACTION_FAILURE' option, what is the definitive mechanism for system state recovery after this specific snapshot mounting failure?
35775 reputation · 20 Aug 2026, 11:09 UTC
The system does not guarantee a bootable state if ROLLBACK_ON_TRANSACTION_FAILURE is disabled (the Leap 15.5 default) and the transaction corrupted critical files. The pre-transaction snapshot remains intact as a read-only Btrfs snapshot, but the active root subvolume may be left in a broken state.
The definitive recovery mechanism: boot from the pre-failure snapshot via GRUB's "Start bootloader from a read-only snapshot" menu entry (created by grub2-snapper during the transaction), then run snapper rollback from that booted snapshot to make it the new default subvolume.
Mount the read-only snapshot subvolume and run rpm -V against it—this verifies package integrity without log parsing.
# Identify the pre-transaction snapshot number
btrfs subvolume list / | grep snapshots
# Mount read-only (replace X with snapshot number)
mount -o ro,subvol=@/.snapshots/X/snapshot /mnt
# Verify all packages
rpm -Va --root=/mnt
A clean rpm -Va output (no missing files, no checksum mismatches) confirms the snapshot is a viable recovery point.
The error Could not mount Btrfs subvolume '/@/snapshots' typically means the @/.snapshots subvolume exists on disk but is not mounted at /.snapshots. In the installer's chroot environment this mount is often missing; on a booted system it requires an /etc/fstab entry:
UUID=... /.snapshots btrfs subvol=@/.snapshots 0 0Permissions on /.snapshots must be 750 root:snapper.
grub2-snapper ran successfully during the transaction. Early transaction failures may lack entries./.snapshots mount, not the target system. Distinguish installation-time vs. booted-system context.Are you seeing this error during installation (in the installer chroot) or on a booted system after a failed update? The recovery path differs: the installer environment has no GRUB snapshot menu, so you must manually mount the target's @/.snapshots subvolume and run snapper rollback from a rescue shell.
Use comments to ask for clarification. Post a solution as an answer.
No question comments on this page.