[pve-devel] [PATCH pve-docs] local-zfs: document raidz extension for PVE 9/ZFS 2.3.3

[pve-devel] [PATCH pve-docs] local-zfs: document raidz extension for PVE 9/ZFS 2.3.3

[Daniel Herzig]

Add documentation how to extend a raidz vdev with a new disk [0].
Add the note that this will only work for PVE 9 (ZFS 2.3.3).

[0]: https://github.com/openzfs/zfs/pull/15022

Signed-off-by: Daniel Herzig <d.herzig@proxmox.com>
---
 local-zfs.adoc | 17 +++++++++++++++++
 1 file changed, 17 insertions(+)

diff --git a/local-zfs.adoc b/local-zfs.adoc
index c64fb27..4f20d00 100644
--- a/local-zfs.adoc
+++ b/local-zfs.adoc
@@ -389,6 +389,23 @@ xref:sysadmin_zfs_raid_considerations[ZFS RAID Level Considerations]
 to get a rough estimate on how IOPS and bandwidth expectations before setting up
 a pool, especially when wanting to use a RAID-Z mode.
 
+[[sysadmin_zfs_extend_raidz]]
+Extend RAIDZ-N
+^^^^^^^^^^^^^^
+
+NOTE: This feature only works starting with Proxmox VE 9 (ZFS 2.3.3).
+
+Assuming you have an existing `<pool>` with a RAIDZ-N `<raidzN-M>` vdev, you can
+add a new physical disk `<device>` using the following syntax:
+
+----
+zpool attach <pool> <raidzN-M> <device>
+----
+
+You can verify general success by running `zpool status <pool>` and get verbose
+output for all attached disks by running `zpool list <pool> -v`. To inspect the
+new capacity of your pool run `zfs list <pool>`.
+
 [[sysadmin_zfs_create_new_zpool_with_cache]]
 Create a new pool with cache (L2ARC)
 ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
-- 
2.39.5


_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel

[pve-devel] applied: [PATCH pve-docs] local-zfs: document raidz extension for PVE 9/ZFS 2.3.3

[Thomas Lamprecht]

On Thu, 17 Jul 2025 15:37:53 +0200, Daniel Herzig wrote:
> Add documentation how to extend a raidz vdev with a new disk [0].
> Add the note that this will only work for PVE 9 (ZFS 2.3.3).
> 
> [0]: https://github.com/openzfs/zfs/pull/15022
> 
> 

Applied, thanks!

[1/1] local-zfs: document raidz extension for PVE 9/ZFS 2.3.3
      commit: 43d8bb5e4ca0f98c747605848183b7ec1a652945


_______________________________________________
pve-devel mailing list
pve-devel@lists.proxmox.com
https://lists.proxmox.com/cgi-bin/mailman/listinfo/pve-devel