bcachefs-device

Format and add a new device to an existing filesystem

$ sudo bcachefs device add --label [group].[name] [path/to/mountpoint] [path/to/device]

$ bcachefs device evacuate [path/to/device]

$ bcachefs device remove [path/to/device]

bcachefs device command [options] device

bcachefs device manages devices within a running bcachefs filesystem. It allows adding new devices to expand storage, evacuating data before removal, and permanently removing devices.
Device labels organize storage into groups (like ssd or hdd) and individual device names, enabling tiered storage configurations.

--label group.name

Assign a label to categorize the device (e.g., ssd.cache, hdd.bulk)

Force device removal even if it would reduce redundancy

add

Add a new device to the filesystem

Move all data off a device in preparation for removal

Remove a device from the filesystem

Bring an offline device back online

Take a device offline without removing it

Removing devices may take considerable time depending on data volume. Ensure sufficient free space on remaining devices before evacuating. Device operations require the filesystem to be mounted.

bcachefs(8), mount(8)