Skip to content

Free, Open Source, Self-Hosted WhatsApp API Gateway

docs(env): note the boot checks on conversion and archive TTL knobs

Yudhi Armyndharis23d34a1e1b8c
diff --git a/.env.example b/.env.example
index e498958e3..71f7a17b0 100644
--- a/.env.example
+++ b/.env.example
@@ -542,6 +542,8 @@ WEBHOOK_SSRF_PROTECT=true
# prefix: a value ending in /api forwards to /api/api/...
# SESSION_PROXY_TIMEOUT_MS=60000 # ceiling for one forwarded request
+# Media conversion. Each number below must be a positive integer, or the boot fails, and the timeout
+# no greater than 2147483647 ms (Node's timer ceiling), even with conversion disabled.
# MEDIA_CONVERSION_ENABLED=false # default false
# FFMPEG_PATH=ffmpeg # absolute path, for a binary outside PATH
# MEDIA_CONVERSION_TIMEOUT_MS=60000 # kill one conversion after this long (default 60s)
@@ -579,7 +581,8 @@ WEBHOOK_SSRF_PROTECT=true
# fails the boot.
# CHAT_MEDIA_ARCHIVE_MAX_BYTES=26214400 # default 25 MiB
# How long archived files are kept, in days. 0 = forever. Expiry clears the FILE and the row's
-# media columns; the message row itself is never deleted by this.
+# media columns; the message row itself is never deleted by this. A negative or malformed value
+# fails the boot.
# CHAT_MEDIA_ARCHIVE_TTL_DAYS=0 # default 0 (keep forever)
# Orphaned chat-media reconciliation: how often the sweep re-lists chat-media files to find ones no
# row references (crash leftovers), and how long a file must be seen unreferenced before deletion.