// 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
Share

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

  1. FIX 1Windows

    1. 01Move misc\DocFetcher.bat up into the DocFetcher folder
    2. 02Edit the last line and change -Xss2m to -Xss4m
    3. 03Always launch DocFetcher through DocFetcher.bat
    Did this fix it?
  2. FIX 2Linux and macOS

    1. 01Open DocFetcher.sh in a text editor
    2. 02Change -Xss2m to -Xss4m and save
    3. 03Start DocFetcher from the script
    Did this fix it?
  3. FIX 3Rebuild the index

    1. 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 us

Watch DocFetcher Get an email when its price changes, it has an outage, or we publish a new fix. No spam.

Fixed it? Share this guide

The same problem in other apps

All not loading, error messages & connection guides →

Other DocFetcher errors

All 10 DocFetcher errors and fixes →