// troubleshooting guide · docfetcher
DocFetcher Won't Start or Open
- Status
- Workaround available
- platforms:
- Windows, macOS, Linux
- updated:
- November 19, 2026
- reports:
- 2
- Method
- how we research
RUNBOOK · docfetcher/wont-start4 FIXES
// quick answer
If DocFetcher does nothing when launched, disable the startup manual and HTML preview in settings-conf.txt, then try the script launcher to see the error. Old versions also fail without a matching 64-bit Java.
Most likely fix: Turn off the startup manual and HTML preview
How to fix it
// try these in order, the most common fix is first
FIX 1Turn off the startup manual and HTML preview
- 01Close DocFetcher
- 02Open settings-conf.txt in the conf folder: C:\Users\<you>\AppData\Roaming\DocFetcher\conf (Windows), ~/.docfetcher/conf (Linux/macOS) or <app folder>\conf (portable)
- 03Add the lines ShowManualOnStartup = false and PreferHtmlPreview = false
- 04Optionally add HotkeyEnabled = false, then start DocFetcher
Did this fix it?FIX 2Launch from the script to see the error
- 01Windows: move misc\DocFetcher.bat into the DocFetcher folder and run it from a command prompt
- 02Linux: chmod +x DocFetcher.sh and run ./DocFetcher.sh in a terminal
- 03macOS: cd into DocFetcher.app/Contents/MacOS in Terminal and run the executable there
Did this fix it?FIX 3Update to 1.1.26 or newer
- 01Install the latest release, which bundles its own Java runtime
- 02Note it is 64-bit only: Windows 7 SP1+, macOS 11+, Linux with GTK 3
Did this fix it?FIX 4Update graphics drivers
- 01If startup fails right after a GPU driver update, install a newer or older driver version
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
Double-clicking DocFetcher shows nothing, the window flashes and closes, or it hangs on startup.
Why it happens
- C-01Embedded HTML preview or startup manual failing to load
- C-02Global hotkey conflict
- C-03Graphics driver problems (some NVIDIA 378.xx drivers were reported)
- C-04Old version without a bundled Java, or 32-bit Java on 64-bit Windows
// this guide also covers
- docfetcher won't start
- docfetcher not opening
- docfetcher doesn't start
- docfetcher not launching windows 11
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 usOther DocFetcher errors
- DocFetcher Crashes With 'Program Died' Error
- DocFetcher Out of Memory: How to Increase the Memory Limit
- DocFetcher Not Finding Text in Files
- DocFetcher Not Searching Scanned PDFs
- DocFetcher 'Folder Hierarchy Is Too Deep' Error
- DocFetcher High CPU Usage
- DocFetcher Index Not Updating
- Outlook Won't Start After DocFetcher Indexing