1 files changed, 14 insertions, 1 deletions

diff --git a/.env.example b/.env.example
index 2dc5266..cb797a8 100644
--- a/.env.example
+++ b/.env.example
@@ -189,4 +189,17 @@
 #   NGIT_ARCHIVE_WHITELIST=npub1alice...
 #   NGIT_ARCHIVE_WHITELIST=npub1alice...,npub1bob.../linux
 #   NGIT_ARCHIVE_WHITELIST=bitcoin-core,linux,rust
-# NGIT_ARCHIVE_WHITELIST=
\ No newline at end of file
+# NGIT_ARCHIVE_WHITELIST=
+
+# Archive read-only mode (relay is read-only sync of archived repositories)
+# When true:
+#   - NIP-11 includes GRASP-05 in supported_grasps
+#   - NIP-11 curation field describes archive scope
+#   - Repository announcements not listing this service are accepted per whitelist/archive-all
+# When false:
+#   - Archive mode disabled (standard GRASP-01 operation)
+#
+# CLI: --archive-read-only
+# Default: true if NGIT_ARCHIVE_ALL or NGIT_ARCHIVE_WHITELIST is set, false otherwise
+# Note: Setting to true without archive config causes startup error
+# NGIT_ARCHIVE_READ_ONLY=
\ No newline at end of file