QuickBooks Error H202: What It Means and How to Fix It
Key Takeaways
- QuickBooks error H202 means a workstation cannot reach the server that hosts the company file, so QuickBooks cannot open it in multi-user mode.
- Intuit’s fix order: confirm only the server hosts, run Database Server Manager from the Tool Hub on the server, run File Doctor’s network check, then check the two services, the firewall, and the network.
- H101, H303, and H505 are a different problem, where a workstation is set to host. Only the server should.
- For QuickBooks 2019 and later, the firewall needs port 8019 plus one dynamic port, found on Database Server Manager’s Port Monitor tab, not a fixed range.
- Database Server Manager does not support NAS devices, so the company file has to live on a Windows computer or server.
You open QuickBooks, choose multi-user mode, and instead of the company file you get a dialog saying the file is on another computer and QuickBooks needs some help connecting. That is error H202, one of the most common problems in a multi-user QuickBooks Desktop setup and one of the most frustrating, because the message points at the network and the network is nobody’s favorite thing to debug.
This guide is built around Intuit’s current procedure, which was updated in August 2026, and adds the details that decide whether the fix actually works: which computer to run each tool on, which ports to open for 2019 and later versions, and how to tell a server problem from a single-workstation problem. It also leaves out advice that no longer holds up, such as reaching for third-party repair software.
What Is QuickBooks Error H202?
The H202 dialog usually reads, “This company file is on another computer, and QuickBooks needs some help connecting,” and Intuit’s community labels the code a problem with the multi-user hosting setup. According to Intuit, H202, along with H101, H303, and H505, occurs when something blocks the multi-user connection to your server computer. In practice that means a workstation cannot communicate with the company file stored on the host server.
Two terms matter throughout this guide. The server is the computer that stores the company file and runs QuickBooks Database Server Manager, the service that lets other computers find and open that file. The workstations are the other computers on the network. Intuit documents two ways to set up the server: the Full Program option, where full QuickBooks Desktop and Database Server Manager are both installed on the server, and the Server Only option, where only Database Server Manager is installed. Which one you use changes one or two of the steps below. Intuit’s guidance covers QuickBooks Desktop Pro Plus, Premier Plus, Accountant Desktop Plus, and Enterprise Diamond, Gold, and Platinum.
The simplest way to understand H202 is as a trip with four checkpoints. The workstation has to find the server by name, get through the firewall, reach the QuickBooks services, and find hosting turned on. When any one of them fails, QuickBooks reports the same code, which is why a single fix rarely covers every case.
H202 vs. H101, H303, and H505
Intuit publishes one article for H202 and H505 because both come down to the multi-user connection, but the fixes diverge in an important way.
| Code | What Intuit says it means | Where to start |
|---|---|---|
| H202 | A workstation cannot communicate with the company file on the host server | Steps 2 to 8 below: Database Server Manager, services, firewall, and network |
| H101, H303, H505 | One or more workstations are set to be the server, and only the server should host multi-user mode | Step 1 below: turn hosting off on workstations and on at the server |
If your code is H505 rather than H202, our walkthrough for the H505 variant covers that side in more depth. If you are not sure, the order in this guide handles both, because Step 1 is the check that resolves the H101, H303, and H505 family.
What Causes Error H202?
Intuit treats H202 as a connectivity problem, and its fix list maps directly onto the usual causes.
- Database Server Manager is missing, stopped, or the wrong version. Intuit says to install it on the server for each version of QuickBooks you use, and a version mismatch between the manager and QuickBooks is a known reason connections fail.
- The QuickBooks services are not running or lack permissions. Two Windows services, QuickBooksDBXX and QBCFMonitorService, must be running on the server with administrator rights.
- A firewall or security program blocks QuickBooks. The ports QuickBooks uses must be open on the server.
- Hosting is set wrong. The server should host multi-user access, and workstations should not.
- A workstation cannot find the server by name. This is a name lookup problem, handled through DNS or the hosts file.
- The network itself is struggling. Lost packets, slow replies, or Network Discovery turned off all break the connection.
- The company file lives on an unsupported device. Intuit states that Database Server Manager does not support devices such as Network Attached Storage (NAS).
H202 also tends to appear right after something changes: a new router, a new internet provider, a Windows update, a new QuickBooks version, a new workstation, or a moved company file. If you can name the change, you have found your starting point, and the quiz later in this guide uses exactly that.
What Are the Symptoms of Error H202?
- A dialog labeled H202 when you switch to multi-user mode or open a company file stored on another computer
- The error on every workstation, or only on one or two of them, which tells you whether to look at the server or at a specific computer
- A company file that still opens normally on the server itself, in single-user mode
- An error that began right after a network, Windows, or QuickBooks change
Before You Start
- Identify the server. It is the computer that stores the company file. Every other computer is a workstation.
- Note who sees the error. All workstations points to the server side. One or two workstations points to those computers.
- Back up the company file. Most steps here do not touch your data, but a backup from File, Backup Company, Create Local Backup costs a minute and covers the steps that rename files.
- Have administrator access. You will need Windows administrator rights on the server and your QuickBooks admin password for File Doctor.
- Close QuickBooks on every computer before you run Tool Hub programs, which Intuit requires.
- Record the server’s name and IP address. On the server, open Command Prompt and run ipconfig /all, then note the Host Name and the IPv4 Address. Steps 6 and 7 use both.
How to Fix QuickBooks Error H202
Work through the steps in order and test after each one: on a workstation that showed H202, choose File, then Switch to Multi-user Mode. Stop as soon as it opens without the error.
The order follows Intuit’s, with the quick checks first. Confirming the hosting setting costs a minute and changes nothing. The Tool Hub scan comes next because it repairs firewall permissions automatically and settles many cases on its own. The manual checks come after, from most to least common, and the changes that touch files come last.
-
Step 1: Confirm only the server is hosting
On the server, open QuickBooks and go to File, then Utilities. If you see Host Multi-User Access, select it, because the server needs hosting on. If you see Stop Hosting Multi-User Access, leave it alone, since hosting is already on. Then check each workstation the same way, without opening the company file: if a workstation shows Stop Hosting Multi-User Access, select it, because only the server should host. Intuit ties wrongly hosting workstations to H101, H303, and H505, but one stray host can muddy any multi-user setup. Our guide to setting up multi-user hosting on the server covers this setting in more detail.
-
Step 2: Run Database Server Manager from the Tool Hub
On the server, close QuickBooks and install the QuickBooks Tool Hub. Intuit lists version 1.6.0.8 as the current release and recommends Windows 11, 64-bit. Open the Tool Hub, choose Network Issues, then select QuickBooks Database Server Manager, which prompts you to install it if it is missing. If your company file folder appears, select Start Scan. If it does not, choose Browse, point to the folder, then Start Scan. The scan repairs your firewall permissions automatically. When it finishes, close it, open QuickBooks on each workstation that showed H202, and choose File, then Switch to Multi-user Mode. If the server doubles as a workstation, test it too. Install Database Server Manager for every QuickBooks version your company runs, since Intuit calls for one per version.
-
Step 3: Run File Doctor’s network check
Still in the Tool Hub, choose Company File Issues and then Run QuickBooks File Doctor. It can take a minute to open. Select your company file from the dropdown, or Browse to find it, choose Check your Network, the top option, and select Continue. Enter your QuickBooks admin password, select Next, and test multi-user mode from the workstations again. If everything opens, you are done.
-
Step 4: Check the two QuickBooks services on the server
Open Run, enter services.msc, and press Enter. Find QuickBooksDBXX, where XX is your QuickBooks version plus 10, so QuickBooks 2023 is QuickBooksDB33. Double-click it, set Startup type to Automatic, and start the service if it is not running. On the Recovery tab, choose Restart the Service for First failure, Second failure, and Subsequent failures, then select Apply and OK. Repeat all of it for QBCFMonitorService. Both services also need administrator permissions on the server, which Intuit lists as its own fix. Then test from a workstation.
-
Step 5: Open the firewall for QuickBooks
If the Tool Hub scan did not settle it, add firewall exceptions manually on the server. For QuickBooks Desktop 2019 and later, Intuit’s port format is 8019 plus one dynamic port that QuickBooks assigns at installation. To find yours, open QuickBooks Database Server Manager from the Start menu, go to the Port Monitor tab, find your QuickBooks version, and note the Port Number. Then, in Windows Defender Firewall’s advanced settings, create an inbound rule for TCP that allows 8019 and that port number, and name it something like QBPorts plus the year. Older versions use fixed ports, for example 8019, 56728, and 55378 to 55382 for QuickBooks 2018. After any port change, open the Scan Folders tab in Database Server Manager and select Scan Now so permissions refresh. Intuit’s firewall and security settings article lists the ports by year, and our guide to unblocking QuickBooks in Windows Firewall walks through the Windows side. Third-party security software needs the same exceptions.
-
Step 6: Test the network, then fix name lookup
H202 often comes down to a workstation that cannot find the server. Turn on Network Discovery on the server and on the affected workstations: open Network and Sharing Center, choose Change advanced sharing settings, and make sure Turn on network discovery is selected under both Network discovery and File and printer sharing. Then, from each affected workstation, open Command Prompt and run ping followed by the server name you recorded earlier. A reply to every packet with no loss means the network path is healthy. Lost packets or very slow replies point to a network problem, and Intuit recommends bringing in an IT professional at that point. If the ping fails by name but works when you ping the server’s IP address, name lookup is the problem, and the next section shows the standard workaround.
-
Step 7: Match versions, update, and reset the .ND file
Make sure Database Server Manager is installed on the server for each QuickBooks version in use, and keep QuickBooks and Database Server Manager on the same update level. Workstations running a newer QuickBooks than the server’s Database Server Manager is a reason connections fail that Intuit’s own community moderators call out. If H202 persists, close QuickBooks everywhere, open the company file folder on the server, and rename the file that has your company file’s name and an .ND extension, for example company.qbw.nd, so it ends in .OLD. Then run Database Server Manager’s Scan Now again to rebuild it. Leave the .QBW company file itself alone. Some guides also rename the .TLG file, but that is the transaction log and has nothing to do with the connection, so leave it unless Intuit support asks you to touch it.
-
Step 8: Check for special setups
Two setups need different handling. Database Server Manager does not support devices such as NAS, so a company file stored on one has to move to a Windows computer or server. Intuit also publishes separate H202 articles for a company file hosted on a non-Windows server and for Windows Server 2012 Essentials R2, so use those if either describes you. And if the file sits on a workstation that doubles as the server, make sure that computer is the only host and run Database Server Manager there.
Adding the Server to the Hosts File
Use this when pinging the server by name fails but pinging its IP address works. It tells the workstation directly which address belongs to the server name, so it no longer depends on DNS. Do it on each affected workstation.
- Open Notepad as an administrator by right-clicking it in the Start menu and choosing Run as administrator.
- Choose File, then Open, set the file type to All Files, and open C:\Windows\System32\drivers\etc\hosts.
- At the bottom of the file, add a new line with the server’s IPv4 address, a space, and the server name, for example 192.168.1.20 OFFICE-SRV, using your own values.
- Save the file, close Notepad, and test File, then Switch to Multi-user Mode in QuickBooks.
If the server’s IP address ever changes, the line in the hosts file goes stale and the error can return. Reserving a fixed address for the server in your router avoids that, and it is worth doing whether or not you needed this fix.
Quick Reference: Where to Click
| Step | Where to go | What it fixes |
|---|---|---|
| 1. Hosting | File > Utilities on the server and each workstation | Makes the server the only host |
| 2. Database Server Manager | Tool Hub > Network Issues > QuickBooks Database Server Manager > Start Scan | Finds the file and repairs firewall permissions |
| 3. File Doctor | Tool Hub > Company File Issues > Run QuickBooks File Doctor > Check your Network | Diagnoses network and file access problems |
| 4. Services | Run > services.msc > QuickBooksDBXX and QBCFMonitorService | Keeps the two services running and restarting |
| 5. Firewall | Database Server Manager > Port Monitor, then Windows Defender Firewall inbound rule | Opens port 8019 and the dynamic port |
| 6. Network | Network and Sharing Center, then ipconfig /all and ping from a workstation | Confirms the workstation can reach the server by name |
| 7. Versions and .ND file | Database Server Manager per version, then rename the .ND file and Scan Now | Removes version mismatches and a damaged network file |
| 8. Special setups | Move the file off a NAS, or use Intuit’s non-Windows and Server 2012 articles | Handles unsupported hosting |
Not Sure Where to Start?
Where you start depends on who sees the error, where the file lives, and what changed. Answer three quick questions and the helper below points you to the right step.
Which Fix Should You Try First?
Who sees the error, where the file lives, and what changed recently matter more than any generic checklist. Answer three quick questions and get your starting step, no email required.
1. Who sees H202?
How to Keep H202 From Coming Back
- Keep one host. Hosting stays on at the server only. Check it again whenever a new workstation is set up.
- Give the server a fixed address and a stable name. A reserved IP address in your router means workstations keep finding it at the same place.
- Update QuickBooks and Database Server Manager together. Install Database Server Manager for each QuickBooks version you run, and keep them on the same update level.
- Rescan after changes. Run the Database Server Manager scan whenever you move the company file or add a folder.
- Store the file on a Windows computer. Avoid NAS devices and other unsupported storage.
- Retest after network changes. After a new router, firewall rule, or Windows update, open multi-user mode the same day instead of waiting for someone to hit the error.
- Write it down. A one-page record of the server name, IP address, QuickBooks versions, and firewall ports turns the next incident from detective work into a checklist.
- Watch speed as well as connection. If multi-user mode works but feels slow, our guide to what slows multi-user QuickBooks down covers the usual causes. And if staff connect from outside the office, the ways to reach QuickBooks remotely compare your options, since opening a company file across a VPN adds more places for name lookup and ports to fail.
What If Nothing Works?
- Confirm the code. If the dialog says H505, H101, or H303, go back to Step 1, since those point to hosting settings.
- Open the file on the server in single-user mode. If it will not open there either, the problem is the file or its folder permissions, not the network, and our guide to repairing a damaged company file is the better path.
- Stop on packet loss. If pings drop or crawl, the issue is your network hardware or provider, and an IT professional will solve it faster than more QuickBooks steps.
- Skip third-party repair tools. Intuit's own Tool Hub covers the legitimate fixes, and unknown utilities can make a network problem worse.
- Contact Intuit support. Bring the exact error text, which workstations are affected, the server's version of QuickBooks and Database Server Manager, and a list of the steps you have tried.
Does a Hosted Environment Make H202 Disappear?
For the multi-user error specifically, it comes close, and the reason is structural. H202 exists because a workstation has to reach a company file stored on another computer, across a network that can fail in several places. In a hosted environment, each person's QuickBooks session runs on the provider's server right next to the company file, so there is no workstation-to-server file connection for H202 to break. People connect to the session, not to the file.
That makes the error much less likely, but it is not a magic fix. A hosted setup still needs to be configured correctly, a damaged company file is still damaged, and hosting adds a monthly cost. For a two-person office on a reliable network, fixing H202 once and documenting the setup is usually the better call. The picture changes when the error keeps returning, when staff work from home, or when someone ends up as the unofficial IT person for QuickBooks. In those cases, moving to a hosted environment where QuickBooks and the company file share a server removes the network layer that causes the error. Our comparison of how LAN, server, and cloud setups stack up for multi-user access lays out the trade-offs.
Already hosted with Apps4Rent and seeing H202? Call us first.
Inside a hosted session, H202 points to a server-side service or setting, which our team can check directly.
Have the exact error text and the time it started ready.
Frequently Asked Questions
-
What is QuickBooks error H202?
QuickBooks error H202 appears in QuickBooks Desktop when a workstation cannot reach the server that hosts the company file in multi-user mode. Intuit describes it as something blocking the multi-user connection, so workstations cannot communicate with the company file stored on the host server.
-
What causes QuickBooks error H202?
Common causes are Database Server Manager missing, stopped, or the wrong version for your QuickBooks, QuickBooks services that are not running or lack permissions, a firewall blocking QuickBooks ports, wrong hosting settings, a workstation that cannot find the server by name, general network problems, and a company file stored on an unsupported device such as a NAS.
-
How do I fix QuickBooks error H202?
Follow Intuit's order: confirm only the server hosts multi-user access, run Database Server Manager from the QuickBooks Tool Hub on the server and scan the company file folder, run File Doctor's Check your Network option, check the QuickBooksDBXX and QBCFMonitorService services, open the firewall for QuickBooks, and test the network by pinging the server. Test multi-user mode on a workstation after each step.
-
What is the difference between H202 and H505?
H202 means a workstation cannot reach the server. H101, H303, and H505 mean one or more workstations are set to host multi-user mode, which only the server should do. The H202 fixes focus on services, the firewall, and the network, while the H505 family is fixed by turning hosting off on workstations.
-
Which ports does QuickBooks use for multi-user mode?
For QuickBooks Desktop 2019 and later, Intuit's format is port 8019 plus one dynamic port assigned at installation, which you find on the Port Monitor tab of QuickBooks Database Server Manager. Older versions use fixed ports, for example 8019, 56728, and 55378 to 55382 for QuickBooks 2018.
-
What is QuickBooks Database Server Manager?
It is the service on the server that lets workstations find and open company files in multi-user mode. Its scan also repairs firewall permissions automatically. Intuit says to install it on the server for each version of QuickBooks you use, and you can run it from the QuickBooks Tool Hub.
-
Can I keep my QuickBooks company file on a NAS?
Not if you want multi-user mode to work reliably. Intuit states that Database Server Manager does not support devices such as Network Attached Storage, and a company file stored on one can cause H202 and H505. Move the file to a Windows computer or server instead.
-
Can H202 happen when working over a VPN or remotely?
Yes. A VPN or remote connection adds a network path that must resolve the server name and allow the QuickBooks ports, so name lookup and firewall problems show up more often. If remote staff use QuickBooks regularly, connecting to a session that runs next to the company file avoids opening the file across the connection.
-
Does hosting QuickBooks in the cloud stop H202?
It makes the error much less likely. In a hosted environment each user's QuickBooks session runs on the provider's server next to the company file, so there is no workstation-to-server file connection for H202 to break. It does not replace a sound setup, and it adds a monthly cost that a small office on a reliable network may not need.
The Bottom Line
QuickBooks error H202 is a reachability problem: a workstation could not get to the server that holds the company file. That is why the fix is a short, ordered checklist instead of a mystery. Confirm that only the server hosts, run Database Server Manager from the Tool Hub, check the two services, open the firewall for 8019 and your dynamic port, and test the network from the workstation that fails. Match your versions, handle NAS and non-Windows servers separately, and write the setup down so the next incident takes minutes. If the error keeps coming back, that is useful information too: it may mean the office network has become the wrong place for the company file to live.
These steps follow Intuit's published guidance for QuickBooks Desktop, last updated in August 2026. Menus and tool versions vary. Network changes can affect your whole office, so involve an IT professional if you are unsure, and back up your company file before you change anything. Information was last reviewed in November 2026.
Request for price promotions