How to open a Btrfs drive on Mac

A Linux backup drive or SSD formatted as Btrfs will not mount natively in macOS. vmount runs Linux filesystem support inside a small virtual machine so you can browse the mounted files on your Apple Silicon Mac.

Check your drive before you start

You need an Apple Silicon Mac running macOS 14 or later and an external drive containing Btrfs. This guide covers opening an existing drive, not creating or repairing a filesystem. If your disk uses LUKS encryption, follow the LUKS guide first.

Download vmount free to browse folders in the app. Pro is $29 USD once and adds export to your Mac, Finder access and write operations.

Mount and browse the Btrfs partition

  1. Install vmount. Run the signed .pkg installer, then open vmount from Applications.
  2. Connect the external drive. Dismiss any macOS prompt to initialize it. You do not need to erase or format an existing Linux drive.
  3. Identify the right disk. Match its name and capacity in the picker. Keep the lock closed for read-only access, then click MOUNT.
  4. Browse the mounted folders. Open the Btrfs mount in vmount. Check that the folders match the disk you intended to open before enabling writes.
  5. Copy files with Pro. Select a file and use Export... from its context menu to save it to your Mac. Click FINDER if you prefer Finder browsing. Writing requires Pro and read/write access.
  6. Eject after transfers finish. If Finder is mounted, use its EJECT control first; then use vmount’s disk EJECT to return to the picker before unplugging.

Why the folder layout may look different

Btrfs can divide a filesystem into subvolumes, each with its own directory hierarchy. The filesystem’s default subvolume affects what appears when it is mounted without an explicit subvolume selection. A Linux installation may therefore show a different root than you expected. The Btrfs subvolume documentation explains this layout.

vmount’s disk mount uses the filesystem’s mount behavior; this guide does not promise a dedicated snapshot or subvolume selector. If a home folder or snapshot is missing, compare the layout with the original Linux system before assuming files were lost.

If mounting fails

The physical drive is not detected

Check power, cable and enclosure, and look for the device in Disk Utility with View → Show All Devices. Reconnect and reopen vmount. A missing physical device needs a connection check before filesystem troubleshooting.

This disk belongs to a multi-device filesystem

A Btrfs member disk may rely on other devices in its original setup. This guide does not cover assembling a Btrfs RAID or multi-device filesystem. Reconnect the complete setup on Linux rather than treating one member as a standalone drive.

A folder cannot be exported or modified

Export and Finder require Pro; writing also requires read/write access. Linux ownership and permissions can affect individual folders. Read-only snapshots can impose additional restrictions even when write access is enabled.

For filesystem errors, keep the error message and investigate on the original Linux system before repair or formatting. Transfer speed depends on the hardware and files; no throughput is guaranteed.

Related guides

Check your drive with vmount

Browse free. Pro unlocks export, Finder and write operations for $29 USD once.

Download freeUnlock Pro — $29