@@ -365,14 +365,17 @@ When enabling ZFS support, Armbian checks if the running kernel can support ZFS,
365365 The **ARC (Adaptive Replacement Cache)** is ZFS's intelligent caching system.
366366
367367 **Recommended Settings:**
368+
368369 - **ARC Min:** 1/8 of RAM (minimum cache size)
369370 - **ARC Max:** 1/2 of RAM (maximum cache size)
370371
371372 For memory-constrained ARM devices (1-2 GB RAM):
373+
372374 - Consider limiting ARC to 256-512 MB to leave memory for applications
373375 - ARC Max = 0 means "use all available RAM" (may not be ideal for small systems)
374376
375377 **Impact:**
378+
376379 - Higher ARC = better read performance for frequently accessed data
377380 - Too high ARC can cause system swapping and degraded performance
378381
@@ -381,9 +384,11 @@ When enabling ZFS support, Armbian checks if the running kernel can support ZFS,
381384 **Dirty data** is modified data waiting to be written to disk.
382385
383386 **Recommended Setting:**
387+
384388 - **4% of RAM** (or 4% of ARC size, whichever is smaller)
385389
386390 **Impact:**
391+
387392 - Higher values = better write performance, more data loss risk on power failure
388393 - Lower values = safer data, more frequent disk writes
389394
@@ -392,11 +397,13 @@ When enabling ZFS support, Armbian checks if the running kernel can support ZFS,
392397 **TXG (Transaction Group)** controls how often ZFS writes changes to disk.
393398
394399 **Recommended Setting:**
400+
395401 - **5 seconds** (default)
396402
397403 **Range:** 1-30 seconds
398404
399405 **Impact:**
406+
400407 - Lower (1-3s): Better data safety, more disk writes, lower performance
401408 - Higher (10-30s): Better performance, more data loss risk on power failure
402409
@@ -405,6 +412,7 @@ When enabling ZFS support, Armbian checks if the running kernel can support ZFS,
405412 ZFS compression is transparent and can actually **improve performance** by reducing I/O.
406413
407414 **Options:**
415+
408416 - **lz4**: Fast, good compression (recommended for most)
409417 - **zstd**: Better compression ratio, slightly slower CPU usage
410418 - **gzip**: Maximum compression, slowest
@@ -426,24 +434,10 @@ When enabling ZFS support, Armbian checks if the running kernel can support ZFS,
426434 modprobe zfs
427435 ```
428436
429- === "Viewing Current Settings"
430-
431- Current settings can be viewed in the tuning interface or directly:
432-
433- ```bash
434- # View module parameters
435- cat /sys/module/zfs/parameters/zfs_arc_max
436- cat /sys/module/zfs/parameters/zfs_arc_min
437- cat /sys/module/zfs/parameters/zfs_dirty_data_max
438- cat /sys/module/zfs/parameters/zfs_txg_timeout
439-
440- # View configuration file
441- cat /etc/modprobe.d/zfs.conf
442- ```
443-
444437=== "Reset to Defaults"
445438
446439 The tuning interface includes a "Reset to Defaults" option that:
440+
447441 - Removes custom configuration from `/etc/modprobe.d/zfs.conf`
448442 - Resets all parameters to ZFS defaults
449443 - Requires module reload to take effect
0 commit comments