// troubleshooting guide · docfetcher
DocFetcher 'Folder Hierarchy Is Too Deep' Error
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux
- updated:
- November 19, 2026
- Method
- how we research
RUNBOOK · docfetcher/folder-hierarchy-too-deep3 FIXES
// quick answer
This error means Java ran out of stack space walking deeply nested folders. Raise -Xss2m to -Xss4m in the launcher script and always start DocFetcher from that script.
Most likely fix: Windows
How to fix it
// try these in order, the most common fix is first
FIX 1Windows
- 01Move misc\DocFetcher.bat up into the DocFetcher folder
- 02Edit the last line and change -Xss2m to -Xss4m
- 03Always launch DocFetcher through DocFetcher.bat
Did this fix it?FIX 2Linux and macOS
- 01Open DocFetcher.sh in a text editor
- 02Change -Xss2m to -Xss4m and save
- 03Start DocFetcher from the script
Did this fix it?FIX 3Rebuild the index
- 01Right-click the failed index and choose Rebuild Index
Did this fix it?
SANDBOX · docfetcher RUNS IN YOUR BROWSER
Try it: a launcher with snippets and clipboard history
A hands-on DocFetcher-style sandbox, including the spots where users get stuck. See where problems like this one start. 1-2 minutes, nothing is saved.
Symptoms
Indexing stops with a message that the folder hierarchy is too deep.
Why it happens
- C-01Very deeply nested folder structures
- C-02Default Java thread stack size (-Xss2m) too small
// this guide also covers
- docfetcher folder hierarchy is too deep
- docfetcher stack overflow
- docfetcher deep folders
Still not working?
If DocFetcher keeps failing, you're not alone. See every DocFetcher problem users report or the alternatives people switch to.
Have an app idea? Our small team builds any software: web and mobile apps, games, desktop, AI tools. Price agreed together.
Talk to usThe same problem in other apps
All not loading, error messages & connection guides →
Agent Ransack Network Drive Search Not Working (Agent Ransack)
UltraSearch 'Network Drives Are Not Supported' Error (UltraSearch)
Other DocFetcher errors
- DocFetcher Crashes With 'Program Died' Error
- DocFetcher Out of Memory: How to Increase the Memory Limit
- DocFetcher Won't Start or Open
- DocFetcher Not Finding Text in Files
- DocFetcher Not Searching Scanned PDFs
- DocFetcher High CPU Usage
- DocFetcher Index Not Updating
- Outlook Won't Start After DocFetcher Indexing