From 97e250be4b1cdeed31d1ae4b5fc3708e64e0eaf7 Mon Sep 17 00:00:00 2001
From: CREDO23 <bakerathierry@gmail.com>
Date: Fri, 10 Jul 2026 17:25:48 +0200
Subject: [PATCH] docs(env): document TIKTOK_LISTING_MAX_ATTEMPTS

---
 surfsense_backend/.env.example | 3 +++
 1 file changed, 3 insertions(+)

diff --git a/surfsense_backend/.env.example b/surfsense_backend/.env.example
index c0e9ff5bd..d94acd14e 100644
--- a/surfsense_backend/.env.example
+++ b/surfsense_backend/.env.example
@@ -293,6 +293,9 @@ MICROS_PER_PAGE=1000
 # TIKTOK_MICROS_PER_VIDEO=3500
 # TIKTOK_MICROS_PER_USER=2500
 # TIKTOK_MICROS_PER_COMMENT=1500
+# Browser-listing retries when a feed is empty (profile feed is withheld from
+# flagged IPs; each retry draws a fresh rotating exit IP). Set to 1 for a static IP.
+# TIKTOK_LISTING_MAX_ATTEMPTS=3
 
 # Low-balance warning threshold (micro-USD), surfaced to the UI. Default $0.50.
 CREDIT_LOW_BALANCE_WARNING_MICROS=500000