How To Fix QuickBooks Error H202 In Multi-User Mode (2026)
Error H202 appears when a QuickBooks Desktop workstation cannot switch to multi-user mode because it cannot reach the company file on the host computer.
Intuit groups it with errors H101, H303 and H505, which share the same family of network and hosting causes.
This guide walks through Intuit’s fixes in the order its support page gives them, starting with the automatic tools.
Quick answer: what each error means
Intuit says all four errors mean something is blocking the multi-user connection between the workstations and the server that hosts the company file.
| Error | What Intuit says it means | Where to start |
|---|---|---|
| H202 | Workstations cannot reach the company file on the host | Tool Hub, then services, firewall and ping checks |
| H101 | A workstation is set up to host multi-user mode | File, Utilities on each workstation |
| H303 | A workstation is set up to host multi-user mode | File, Utilities on each workstation |
| H505 | A workstation is set up to host multi-user mode | File, Utilities on each workstation |
Know how your server is set up
Intuit describes two ways to host the company file, and the fixes assume you know which one you use.
- Full Program option: full QuickBooks Desktop and Database Server Manager are both installed on the server.
- Server Only option: only Database Server Manager is installed on the server.
The page also warns that QuickBooks Database Server Manager does not support Network Attached Storage devices.
Install the QuickBooks Tool Hub on the server
Intuit recommends the Tool Hub as the first option, and it should go on the server computer.
- Close QuickBooks.
- Download QuickBooksToolHub.exe, which the page lists as version 1.6.0.8, and save it somewhere easy to find.
- Run the file, follow the prompts and accept the terms.
- Open the Tool Hub from its desktop icon, or search Windows for “QuickBooks Tool Hub”.
To check an installed version, open the Tool Hub and look at the Home tab.
Run QuickBooks Database Server Manager
This tool scans the folders that hold your company files and repairs the firewall permissions for them.
- In the Tool Hub, select Network Issues.
- Select QuickBooks Database Server Manager, and install QuickBooks if it prompts you because it is missing on the server.
- Select Start Scan if your company file folders are listed, or select Browse to find the file first.
- When the scan ends, select Close.
- On each workstation that showed H202, open QuickBooks and select File, then Switch to Multi-user Mode.
Check the server as well if it is also used as a workstation.
Run QuickBooks File Doctor
If the scan did not clear the error, Intuit’s next step is File Doctor, which has a network check.
- In the Tool Hub, select Company File Issues.
- Select Run QuickBooks File Doctor, which can take a minute to open.
- Choose your company file from the dropdown, or select Browse if it is missing.
- Select Check your Network, then Continue.
- Enter the QuickBooks admin password and select Next.
If it does not open, search Windows for “QuickBooks Desktop File Doc” and open it manually.
Check the two QuickBooks services
If H202 continues, Intuit asks you to check the QuickBooksDBXX and QBCFMonitorService services on the server.
- On the server, open the Start menu, search for Run and open it.
- Type services.msc and press Enter.
- Double-click QuickBooksDBXX.
- Set Startup type to Automatic.
- Make sure Service status says Running or Started, and select Start if it does not.
- Open the Recovery tab and set First failure, Second failure and Subsequent failures to Restart the Service.
- Select Apply, then OK, and repeat for QBCFMonitorService.
In QuickBooksDBXX, the XX is your QuickBooks version year plus 10, so QuickBooks 2023 uses QuickBooksDB33.
| Setting | Value Intuit asks for |
|---|---|
| Startup type | Automatic |
| Service status | Running or Started |
| First failure | Restart the Service |
| Second failure | Restart the Service |
| Subsequent failures | Restart the Service |
Then open QuickBooks on each workstation and choose File, then Switch to Multi-user Mode.
Check permissions and the firewall
Intuit’s second manual fix is to give both services admin permissions on the server if they do not have them already.
The third is to set Windows Firewall exceptions for QuickBooks, which Intuit covers in a separate firewall guide.
After each change, reopen QuickBooks on the workstations and try Switch to Multi-user Mode again.
Ping the server from each workstation
This test shows whether the workstation can see the server on your network at all.
| Step | Where | What to do |
|---|---|---|
| 1 | Server and affected workstations | Open Network and Sharing Center, select Change advanced sharing settings, and turn on network discovery under Network discovery and File and printer sharing |
| 2 | Server | Open Run, enter cmd, run ipconfig/all and note the Host Name under Windows IP Configuration |
| 3 | Each workstation with H202 | Open Run, enter cmd, then run ping followed by the server name, with no brackets |
Replies for every packet with no loss mean the server is reachable from that workstation.
Packet loss or very slow replies mean you should stop and bring in an IT professional to look at the network, as Intuit advises.
Fix H101, H303 and H505
These three usually mean one or more workstations are set to host multi-user mode when only the server should.
On each workstation, open QuickBooks without opening a company file and select File, then Utilities.
- If you see Host Multi-User Access, do not select it, and move on to the next workstation.
- If you see Stop Hosting Multi-User Access, select it.
Then open QuickBooks on the server and go to File, then Utilities, where Host Multi-User Access should be the one you select.
If the server shows Stop Hosting Multi-User Access instead, leave it alone because it is already hosting.
Hosting on Linux or Citrix
A separate Intuit article covers H202 when the company file sits on a Fedora Linux server or a Citrix server.
For Fedora, it lists adding the server’s fully qualified domain name to the Windows hosts file, correcting the port entries in QBGlobalAppConfig.ini, or mapping a drive to the server’s IP address.
For Citrix, the fix is to run QuickBooks with server-side application virtualization, and Intuit says it does not support every Citrix setup.
Related guides and official sources
If QuickBooks will not start at all, see our guide to QuickBooks Desktop not opening.
Shared-drive and network problems also show up in other Windows apps, as in TurboTax Desktop not installing or updating.
The steps come from Intuit’s How to fix Error H202 and H505 page and its H202 on a non-Windows server article.