// troubleshooting guide · docfetcher

DocFetcher High CPU Usage

Status
Workaround available
platforms:
Windows, macOS, Linux
updated:
November 19, 2026
reports:
2
Method
how we research
Share

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

  1. FIX 1Turn off folder watching for busy folders

    1. 01Right-click the affected index and choose Rebuild Index
    2. 02In the indexing dialog untick 'Watch folders for file changes'
    3. 03Update that index manually when needed
    Did this fix it?
  2. FIX 2Fix the Linux daemon at 100% CPU

    1. 01Open your indexes folder, e.g. ~/.docfetcher
    2. 02If there is no file named .indexes.txt, create an empty one: touch ~/.docfetcher/.indexes.txt
    3. 03Restart the daemon or log out and back in
    Did this fix it?
  3. FIX 3Exclude churning subfolders

    1. 01In the indexing dialog add a regex exclusion such as .*/\.svn/.* with Match Against set to Absolute path
    2. 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 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 slow, laggy or resource-hungry guides →

Other DocFetcher errors

All 10 DocFetcher errors and fixes →