From ae6f3b55e413331b1b383e04494f97e547058801 Mon Sep 17 00:00:00 2001
From: nbaud <125445692+nbaud@users.noreply.github.com>
Date: Wed, 30 Jul 2025 06:05:37 +0200
Subject: [PATCH] stratis: add page (#17387)

Co-authored-by: Lena <126529524+acuteenvy@users.noreply.github.com>
Co-authored-by: Sebastiaan Speck <12570668+sebastiaanspeck@users.noreply.github.com>
Co-authored-by: Managor <42655600+Managor@users.noreply.github.com>
---
 pages/linux/stratis.md | 37 +++++++++++++++++++++++++++++++++++++
 1 file changed, 37 insertions(+)
 create mode 100644 pages/linux/stratis.md

diff --git a/pages/linux/stratis.md b/pages/linux/stratis.md
new file mode 100644
index 0000000000..a37b258474
--- /dev/null
+++ b/pages/linux/stratis.md
@@ -0,0 +1,37 @@
+# stratis
+
+> Manage local storage pools and volumes using the Stratis storage manager.
+> Stratis volumes use the XFS filesystem and require the `stratisd` service.
+> More information: <https://stratis-storage.github.io>.
+
+- Start the Stratis service (must be active before managing pools or volumes):
+
+`sudo systemctl start stratisd`
+
+- Create a storage pool from one or more devices:
+
+`sudo stratis pool create {{pool_name}} {{/dev/sdX}} {{/dev/sdY}}`
+
+- Create a filesystem (volume) in a pool:
+
+`sudo stratis filesystem create {{pool_name}} {{volume_name}}`
+
+- List all Stratis filesystems:
+
+`sudo stratis filesystem list`
+
+- Format and mount a Stratis volume manually:
+
+`sudo mkfs.xfs /dev/stratis/{{pool_name}}/{{volume_name}} && sudo mount /dev/stratis/{{pool_name}}/{{volume_name}} {{/mnt/target}}`
+
+- Add a volume to `/etc/fstab` for mounting at boot:
+
+`echo /dev/stratis/{{pool_name}}/{{volume_name}} {{/mnt/target}} xfs defaults,x-systemd.requires=stratisd.service 0 0 | sudo tee {{[-a|--append]}} /etc/fstab`
+
+- Extend an existing pool by adding a new device:
+
+`sudo stratis pool add-data {{pool_name}} {{/dev/sdZ}}`
+
+- Delete a volume:
+
+`sudo stratis filesystem destroy {{pool_name}} {{volume_name}}`