backup: clarify that CLI means FS-level and highlight retention-note

[pve-docs.git] / local-btrfs.adoc

diff --git a/local-btrfs.adoc b/local-btrfs.adoc
index 20e992584b437578b10bfd55930d0ca8f2fc2cbe..f68e30df1e6c2bee64d5455652ca9d1f23014f84 100644 (file)
--- a/local-btrfs.adoc
+++ b/local-btrfs.adoc
@@ -143,6 +143,16 @@ mount /my-storage
 ----
 After the next reboot this will be automatically done by the system at boot.
 
+Adding a BTRFS file system to {pve}
+^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
+
+You can add an existing BTRFS file system to {pve} via the web-interface, or
+using the CLI, for example:
+
+----
+pvesm add btrfs my-storage --path /my-storage
+----
+
 Creating a subvolume
 ^^^^^^^^^^^^^^^^^^^^
 
@@ -204,3 +214,13 @@ UUID=<uuid of your root file system> / btrfs defaults,compress=zstd 0 1
 ----
 
 This change will take effect after rebooting.
+
+Checking Space Usage
+^^^^^^^^^^^^^^^^^^^^
+
+The classic `df` tool may output confusing values for some btrfs setups.
+For a better estimate use the `btrfs filesystem usage /PATH` command, for example:
+
+----
+# btrfs fi usage /my-storage
+----