diff --git a/.env.example b/.env.example
index b37450a..e1c674d 100644
--- a/.env.example
+++ b/.env.example
@@ -82,6 +82,13 @@ SNIPE_DB=data/snipe.db
 # Defaults to CF_ORCH_URL if unset.
 # CF_ORCH_COORDINATOR_URL=http://10.1.10.71:7700
 
+# ── Community DB (optional) ──────────────────────────────────────────────────
+# When set, seller trust signals (confirmed scammers added to blocklist) are
+# published to the shared community PostgreSQL for cross-user signal aggregation.
+# Managed instances: set automatically by cf-orch. Self-hosted: leave unset.
+# Requires cf-community-postgres container (cf-orch compose stack).
+# COMMUNITY_DB_URL=postgresql://cf_community:<password>@localhost:5432/cf_community
+
 # ── In-app feedback (beta) ────────────────────────────────────────────────────
 # When set, a feedback FAB appears in the UI and routes submissions to Forgejo.
 # Leave unset to silently hide the button (demo/offline deployments).