Skip to content

Commit 0aa0e7c

Browse files
committed
Automatic documentation update
1 parent f3e3aae commit 0aa0e7c

1 file changed

Lines changed: 9 additions & 15 deletions

File tree

docs/User-Guide_Armbian-Config/System.md

Lines changed: 9 additions & 15 deletions
Original file line numberDiff line numberDiff line change
@@ -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

Comments
 (0)