// troubleshooting guide · docfetcher
DocFetcher High CPU Usage
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux
- updated:
- November 19, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · docfetcher/high-cpu-usage3 FIXES
// quick answer
High CPU usually comes from folder watching reacting to a program that keeps changing files, or on Linux from the daemon when .indexes.txt is missing. Rebuild that index with watching off, or create the empty file.
Most likely fix: Turn off folder watching for busy folders
How to fix it
// try these in order, the most common fix is first
FIX 1Turn off folder watching for busy folders
- 01Right-click the affected index and choose Rebuild Index
- 02In the indexing dialog untick 'Watch folders for file changes'
- 03Update that index manually when needed
Did this fix it?FIX 2Fix the Linux daemon at 100% CPU
- 01Open your indexes folder, e.g. ~/.docfetcher
- 02If there is no file named .indexes.txt, create an empty one: touch ~/.docfetcher/.indexes.txt
- 03Restart the daemon or log out and back in
Did this fix it?FIX 3Exclude churning subfolders
- 01In the indexing dialog add a regex exclusion such as .*/\.svn/.* with Match Against set to Absolute path
- 02Rebuild the 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
DocFetcher or docfetcher-daemon uses a full CPU core constantly, fans spin and the laptop drains, even when you are not searching.
Why it happens
- C-01Another process constantly writing to an indexed folder
- C-02Linux daemon started at login without a .indexes.txt file in the indexes folder
- C-03Indexing a very large folder in the background
// this guide also covers
- docfetcher high cpu
- docfetcher-daemon-linux 100% cpu
- docfetcher using too much cpu
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 slow, laggy or resource-hungry guides →
AnyTXT High CPU and Memory Usage (How to Stop Indexing) (AnyTXT Searcher)
Why Is Agent Ransack So Slow (Agent Ransack)
UltraSearch Slow to Start (UltraSearch)
Everything High Memory and CPU Usage (Everything)
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 'Folder Hierarchy Is Too Deep' Error
- DocFetcher Index Not Updating
- Outlook Won't Start After DocFetcher Indexing