From 8f2f016b61e281b944492d627f0f2f72ed18d1a9 Mon Sep 17 00:00:00 2001
From: maxid <contact@dorninger.co>
Date: Wed, 10 Dec 2025 17:50:04 +0100
Subject: [PATCH] add timeout to docs

---
 Writerside/topics/Indexer-Settings.md | 23 ++++++++++++++++++++++-
 Writerside/topics/troubleshooting.md  | 10 ++++++----
 2 files changed, 28 insertions(+), 5 deletions(-)

diff --git a/Writerside/topics/Indexer-Settings.md b/Writerside/topics/Indexer-Settings.md
index 47712e0..e8231c0 100644
--- a/Writerside/topics/Indexer-Settings.md
+++ b/Writerside/topics/Indexer-Settings.md
@@ -21,7 +21,20 @@ API key for Prowlarr. You can find this in Prowlarr's settings under General.
 
 Set to `true` to reject torrents if there is a URL error when fetching from Prowlarr. Until MediaManager v1.9.0 the
 default behavior was `false`, but from v1.9.0 onwards the default is `true`. It's recommended to set this to `true` to
-avoid adding possibly invalid torrents. 
+avoid adding possibly invalid torrents.
+
+- `timeout_seconds`
+
+Timeout in seconds for requests to Prowlarr. Default is `60` seconds.
+Symptoms of timeouts are typically no search results (*"No torrents found!"*) in conjunction with logs like these:
+
+```
+DEBUG - media_manager.indexer.utils -
+ follow_redirects_to_final_torrent_url():
+  An error occurred during the request for <some-url>:
+   HTTPConnectionPool(host='<some-host>', port=<some-port>):
+    Read timed out. (read timeout=10)
+```
 
 ## Jackett (`[indexers.jackett]`)
 
@@ -41,6 +54,10 @@ API key for Jackett. You can find this in Jackett's dashboard.
 
 List of indexer names to use with Jackett. You can specify which indexers Jackett should search through.
 
+- `timeout_seconds`
+
+Refer to the Prowlarr section for details.
+
 ## Example Configuration
 
 Here's a complete example of the indexers section in your `config.toml`:
@@ -51,10 +68,14 @@ Here's a complete example of the indexers section in your `config.toml`:
 enabled = true
 url = "http://prowlarr:9696"
 api_key = "your_prowlarr_api_key"
+reject_torrents_on_url_error = true
+timeout_secnds = 60
 
 [indexers.jackett]
 enabled = false
 url = "http://jackett:9117"
 api_key = "your_jackett_api_key"
 indexers = ["1337x", "rarbg"]
+timeout_secnds = 60
+
 ```
diff --git a/Writerside/topics/troubleshooting.md b/Writerside/topics/troubleshooting.md
index 4ea0427..55090bb 100644
--- a/Writerside/topics/troubleshooting.md
+++ b/Writerside/topics/troubleshooting.md
@@ -1,9 +1,5 @@
 # Troubleshooting
 
-<note>
-    Note the lack of a trailing slash in some env vars like FRONTEND_URL. This is important.
-</note>
-
 <tip>
     Always check the container and browser logs for more specific error messages
 </tip>
@@ -28,4 +24,10 @@
    <step>Make sure you are using only one volumes for TV, Movies and Downloads. <a href="https://raw.githubusercontent.com/maxdorninger/MediaManager/refs/heads/master/docker-compose.yaml"> See the configuration in the example <code>docker-compose.yaml</code> file.</a></step>
 </procedure>
 
+<procedure title="I get no search results for torrents?" id="procedure-i-get-no-search-results">
+    <step>Try switching to the advanced tab when searching for torrents.</step>
+    <step><a href="Indexer-Settings.md">If you use "slow" indexers, try increasing the timeout threshold.</a></step>
+    <step>If you still don't get any search results, check the logs, they will provide more information on what is going wrong.</step>
+</procedure>
+
 <note>If it still doesn't work, <a href="https://github.com/maxdorninger/MediaManager/issues">please open an Issue.</a> It is possible that a bug is causing the issue.</note>
\ No newline at end of file