If you're facing company file corruption or network access errors, learning how to run QuickBooks File Doctor correctly can save you hours of frustration. This guide walks you through the complete process — from preparation to interpreting your results — while covering related terms like QuickBooks Tool Hub, company file repair, and QB error troubleshooting.
Learn how QuickBooks File Doctor diagnoses company file and network issues. Follow simple troubleshooting steps, or call 1-866-513-4656 for additional guidance when needed.
What Is QuickBooks File Doctor?
Before diving into how to run QuickBooks File Doctor, it helps to understand what it does. File Doctor is a built-in diagnostic utility inside QuickBooks Tool Hub that scans your company file (.QBW) and network settings to detect corruption, hosting errors, and connectivity issues, then attempts automatic company file repair.
Before You Run QuickBooks File Doctor
Proper preparation makes the process smoother and safer:
Back up your company file to an external drive or cloud location
Close QuickBooks on every computer if you're working on a network
Keep your admin credentials ready, since you'll need them during the scan
Confirm only one computer is actively hosting the file in multi-user setups
Update Tool Hub to its latest version for more accurate QB error troubleshooting
Step-by-Step: How to Run QuickBooks File Doctor?
Here's exactly how to run QuickBooks File Doctor once your preparation is complete:
Open QuickBooks Tool Hub from your desktop shortcut
Click "Company File Issues" in the left-hand navigation menu
Select "Run QuickBooks File Doctor" and give it a moment to load
Choose your company file from the dropdown list, or click "Browse" if it isn't shown automatically
Pick a scan type — "Check your file (medium)" for corruption issues, or "Check your network" for connectivity problems
Click "Continue" to begin the diagnostic
Enter your QuickBooks admin username and password when prompted
Let the scan run without interruption — avoid closing the tool or shutting down your computer mid-process
How to Run QuickBooks File Doctor in Multi-User Mode
If your issue involves several users accessing one file over a network, run the tool with these adjustments:
Run File Doctor directly on the server or host computer, not on individual workstations
Confirm the QuickBooksDBXX service is set to start automatically
Check that Windows Firewall has the correct exceptions configured for QuickBooks ports
Restart the host computer after the scan finishes, then reconnect workstations one at a time
Understanding Your Scan Results
Once you run QuickBooks File Doctor, you'll see one of three outcomes:
No issues detected: Your file structure is intact — the problem may lie in your QuickBooks installation instead
Issues found and repaired: File Doctor successfully fixed the detected damage automatically
Issues found but unresolved: You'll likely need to follow up with the Verify Data and Rebuild Data utilities for deeper company file repair
What to Do If Problems Persist After Running File Doctor
Use Verify Data (Window > Verify Data) to pinpoint specific data damage
Follow with Rebuild Data to attempt an automatic fix
Restore from your most recent backup if the corruption is severe
Consult a certified QuickBooks ProAdvisor for advanced QB error troubleshooting if the issue remains unresolved
How Long Does It Take to Run QuickBooks File Doctor?
Scan duration depends largely on your company file size:
Smaller files may complete in just a few minutes
Larger files with extensive transaction histories can take over an hour
Network scans are generally faster than full file structure scans
Avoid interrupting the process regardless of how long it takes, as doing so can leave the repair incomplete.
Best Practices When You Run QuickBooks File Doctor
Run a network scan whenever you add a new workstation to your system
Perform a full file scan after any unexpected shutdown or power outage
Keep Tool Hub updated for improved scan accuracy and better error detection
Schedule regular backups so you always have a clean file to fall back on
People Also Ask (User Queries)
How to run QuickBooks File Doctor?
Open Tool Hub, click "Company File Issues," select "Run QuickBooks File Doctor," choose your file, pick a scan type, enter your admin credentials, and let the scan complete without interruption.
Do I need to close QuickBooks before I run QuickBooks File Doctor?
Yes. QuickBooks Desktop should be completely closed on all computers before starting the scan to avoid conflicts during company file repair.
Can I run QuickBooks File Doctor on a workstation instead of the server?
For multi-user setups, it's best to run the tool on the host or server computer, since that's where the company file and QuickBooksDBXX service actually reside.
What happens if I run QuickBooks File Doctor and it doesn't fix the issue?
If issues remain unresolved, follow up with the Verify Data and Rebuild Data utilities, or restore from a recent backup for further QB error troubleshooting.
Final Thoughts
Knowing how to run QuickBooks File Doctor correctly — from backing up your file beforehand to selecting the right scan type — makes the entire company file repair process far less stressful. While most everyday corruption and network errors get resolved in a single scan, having a backup and knowing your next steps ensures you're covered even if the first attempt doesn't fully resolve the problem.
QuickBooks File Doctor helps identify certain company file and network problems through QuickBooks Tool Hub. The How does QuickBooks File Doctor work process involves selecting your company file, running a diagnostic scan, and reviewing detected issues. If you need assistance with File Doctor troubleshooting, call 1-866-513-4656 for guidance with common QuickBooks problems.
