Alpine Linux - User contributions [en]

Btrfs

2022-05-20T22:16:57Z

Yoshibz:

Documentation how to use Btrfs on Alpine Linux.

== Install ==

Installing [https://wikipedia.org/wiki/Btrfs Btrfs] is relatively straight forward. Install the package and tell Alpine to load the module on startup:

{{Cmd|apk add btrfs-progs
echo btrfs >> /etc/modules}}

To load the module right away, you can use the following command:

{{Cmd|modprobe btrfs}}

== Mounting a volume ==

To mount a volume on boot, add a new entry to your fstab:

UUID=abcdef-0055-4958-990f-1413ed1186ec /var/data btrfs defaults,nofail,subvol=@ 0 0

If you use more specific mounting options like for example:

UUID=005f5994-f51c-4360-8c9b-589fa59ea6fc /mnt/hddext btrfs nofail,rw,noatime,commit=64,nossd,autodefrag,compress=zstd:10 0 2

do not forget to install additional dependencies. If you enabled on the fly compression you need to install zstd:

apk add zstd

More information about mounting can be found in the official [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs wiki]

== Troubleshooting ==

=== Mount failed ===

If you try mounting a Btrfs volume via your /etc/fstab and it doesn't show up, it could be because Btrfs does not know about the drives during boot.

To work around this, you can create an OpenRC service that runs a ''btrfs scan'' to detect the drives. To do so, create a new service under /etc/init.d/btrfs-scan with the following content:

#!/sbin/openrc-run

name="btrfs-scan"

depend() {
before localmount
}

start() {
/sbin/btrfs device scan
}

Make the service executable and register it:

{{Cmd|chmod +x /etc/init.d/btrfs-scan
rc-update add btrfs-scan boot
}}

The volume should mount correctly after a reboot.

== Other Resources ==

# [https://garrit.xyz/posts/2021-12-31-btrfs-on-alpine BTRFS on Alpine Linux]
# [https://nparsons.uk/blog/using-btrfs-on-alpine-linux Using BTRFS on Alpine Linux]
# [https://gitlab-test.alpinelinux.org/alpine/aports/-/issues/9539 Can't mount BTRFS volume using fstab]

Btrfs

2022-05-20T22:12:55Z

Yoshibz:

Documentation how to use Btrfs on Alpine Linux.

== Install ==

Installing [https://wikipedia.org/wiki/Btrfs Btrfs] is relatively straight forward. Install the package and tell Alpine to load the module on startup:

{{Cmd|apk add btrfs-progs
echo btrfs >> /etc/modules}}

To load the module right away, you can use the following command:

{{Cmd|modprobe btrfs}}

== Mounting a volume ==

To mount a volume on boot, add a new entry to your fstab:

UUID=abcdef-0055-4958-990f-1413ed1186ec /var/data btrfs defaults,nofail,subvol=@ 0 0

If you use more specific mounting options like for example:

UUID=005f5994-f51c-4360-8c9b-589fa59ea6fc /mnt/hddext btrfs nofail,rw,relatime,commit=64,nossd,autodefrag,compress=zstd:10 0 2

do not forget to install additional dependencies. If you enabled on the fly compression you need to install zstd:

apk add zstd

More information about mounting can be found in the official [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs wiki]

== Troubleshooting ==

=== Mount failed ===

If you try mounting a Btrfs volume via your /etc/fstab and it doesn't show up, it could be because Btrfs does not know about the drives during boot.

To work around this, you can create an OpenRC service that runs a ''btrfs scan'' to detect the drives. To do so, create a new service under /etc/init.d/btrfs-scan with the following content:

#!/sbin/openrc-run

name="btrfs-scan"

depend() {
before localmount
}

start() {
/sbin/btrfs device scan
}

Make the service executable and register it:

{{Cmd|chmod +x /etc/init.d/btrfs-scan
rc-update add btrfs-scan boot
}}

The volume should mount correctly after a reboot.

== Other Resources ==

# [https://garrit.xyz/posts/2021-12-31-btrfs-on-alpine BTRFS on Alpine Linux]
# [https://nparsons.uk/blog/using-btrfs-on-alpine-linux Using BTRFS on Alpine Linux]
# [https://gitlab-test.alpinelinux.org/alpine/aports/-/issues/9539 Can't mount BTRFS volume using fstab]

Btrfs

2022-05-20T22:11:24Z

Yoshibz: /* Mounting a volume */

Documentation how to use Btrfs on Alpine Linux.

== Install ==

Installing [https://wikipedia.org/wiki/Btrfs Btrfs] is relatively straight forward. Install the package and tell Alpine to load the module on startup:

{{Cmd|apk add btrfs-progs
echo btrfs >> /etc/modules}}

To load the module right away, you can use the following command:

{{Cmd|modprobe btrfs}}

== Mounting a volume ==

To mount a volume on boot, add a new entry to your fstab:

UUID=abcdef-0055-4958-990f-1413ed1186ec /var/data btrfs defaults,nofail,subvol=@ 0 0

If ypu use more specific mounting options like for example:

UUID=005f5994-f51c-4360-8c9b-589fa59ea6fc /mnt/hddext btrfs nofail,rw,relatime,commit=64,nossd,autodefrag,compress=zstd:10 0 2

do not forget to install additional dependencies if you enabled on the fly compression you need to install dependencies:

apk add zstd

More information about mounting can be found in the official [https://btrfs.wiki.kernel.org/index.php/Main_Page Btrfs wiki]

== Troubleshooting ==

=== Mount failed ===

If you try mounting a Btrfs volume via your /etc/fstab and it doesn't show up, it could be because Btrfs does not know about the drives during boot.

To work around this, you can create an OpenRC service that runs a ''btrfs scan'' to detect the drives. To do so, create a new service under /etc/init.d/btrfs-scan with the following content:

#!/sbin/openrc-run

name="btrfs-scan"

depend() {
before localmount
}

start() {
/sbin/btrfs device scan
}

Make the service executable and register it:

{{Cmd|chmod +x /etc/init.d/btrfs-scan
rc-update add btrfs-scan boot
}}

The volume should mount correctly after a reboot.

== Other Resources ==

# [https://garrit.xyz/posts/2021-12-31-btrfs-on-alpine BTRFS on Alpine Linux]
# [https://nparsons.uk/blog/using-btrfs-on-alpine-linux Using BTRFS on Alpine Linux]
# [https://gitlab-test.alpinelinux.org/alpine/aports/-/issues/9539 Can't mount BTRFS volume using fstab]