From da3f88f37d0170ce03715cd50f9558cf56ab99a4 Mon Sep 17 00:00:00 2001
From: Nico <47644445+nicotsx@users.noreply.github.com>
Date: Thu, 29 Jan 2026 22:18:29 +0100
Subject: [PATCH] Update README with TrueNAS configuration guidance

Add note for TrueNAS users regarding ephemeral host path.
---
 README.md | 9 +++++++++
 1 file changed, 9 insertions(+)

diff --git a/README.md b/README.md
index fdb35531..78c3b0b6 100644
--- a/README.md
+++ b/README.md
@@ -64,6 +64,15 @@ services:
 > [!WARNING]
 > Do not try to point `/var/lib/zerobyte` on a network share. You will face permission issues and strong performance degradation.
 
+> [!NOTE]
+> **TrueNAS Users:** The host path `/var/lib` is ephemeral on TrueNAS and will be reset during system upgrades. Instead of using `/var/lib/zerobyte:/var/lib/zerobyte`, create a dedicated ZFS dataset (e.g., `tank/docker/zerobyte`) and mount it instead:
+> ```yaml
+> volumes:
+>   - /etc/localtime:/etc/localtime:ro
+>   - /mnt/tank/docker/zerobyte:/var/lib/zerobyte
+> ```
+> This ensures your configuration, encryption keys, and database persist across TrueNAS upgrades.
+
 Then, run the following command to start Zerobyte:
 
 ```bash