QuickBooks Error H103: The workstation cannot reach the company file host

Error H103 stops a workstation from opening a shared company file; this page explains the code and how our engineers restore multi-user access.

Error H103 belongs to the H series of QuickBooks Desktop networking errors. It appears on a workstation when QuickBooks cannot reach the computer holding the company file. The file itself is nearly always intact. The fault sits in the connection between the two machines, and our engineers clear it by working through a short list of causes.

What does the H103 message say?

The dialog reads: "An error occurred when QuickBooks tried to access the company file. Please try again." The code H103 appears in the same window, usually after that wording. QuickBooks may follow with its own list of suggested steps. You can set that list aside for now, because nearly every case of H103 traces back to one of the five triggers below.

What does error H103 mean?

H codes are network errors. When the company file lives on one computer and others open it across the network, each workstation first asks the host for permission. H103 means that request never completed. The code sits in the same family as H101, H202, H303, and H505. The digits narrow down where the exchange broke, but the practical meaning is blunt: the workstation could not get to the file over the network, so QuickBooks refused to guess.

What triggers H103?

Five causes cover most of the cases our engineers handle.

1. Hosting is switched on in more than one place. QuickBooks expects exactly one host per file.
2. The network descriptor file is stale or damaged. This small .ND file sits beside the company file and stores the host's name and port.
3. A firewall or antivirus tool blocks the ports QuickBooks uses to talk across the network.
4. The host is asleep, switched off, or holding a new address since the descriptor file was written.
5. Name resolution fails, so the workstation cannot turn the host's computer name into an address.

How do you fix H103?

Work through the scenarios in order. The most common cause comes first.

Confirm hosting in exactly one place

1. On the computer holding the company file, open QuickBooks and choose File, then Utilities.
2. If you see "Host Multi-User Access" in the menu, hosting is off here. Select it and confirm.
3. Now open the same menu on the workstation that reported H103.
4. If it offers "Stop Hosting Multi-User Access", select it. Answer yes when QuickBeans offers to make this machine a workstation instead.
5. Close QuickBooks everywhere, reopen it, and try the file from the workstation again.

Refresh the network descriptor file

1. On the host, close the company file and open the QuickBooks Database Server Manager.
2. On the Scan Folders tab, add the folder holding the company file, then start the scan.
3. Let it finish. The scan rewrites the .ND file with the host's current name, address, and service port.
4. Return to the workstation and open the file again.

Test the network path

1. On the host, run ipconfig from a command prompt and note the IPv4 address.
2. On the workstation, ping the host by name, then by that address.
3. If the address answers and the name does not, name resolution is at fault. Open the file using the network path, the form with two backslashes, the server name, and the share name.
4. Prefer that path over a mapped drive letter. Mapped letters belong to one login, so a letter that works for one person can fail for another.

Open the firewall deliberately

1. As a test only, switch off the firewall on the host and try the file from the workstation.
2. If it opens, you have found the cause. Turn the firewall back on before going further.
3. Add exceptions for QuickBooks and for the database server manager.
4. Open port 8019, which every version uses, plus the service port assigned to your version.
5. Read that port in the Database Server Manager; each year of QuickBooks receives its own number when the scan runs.

Check that the host is actually available

1. Confirm the host stays awake during work hours and is not set to sleep.
2. On the host, open the Windows services list and find the entry named QuickBooksDB plus your version number, along with the company file monitoring service.
3. Set both to start automatically, restart them, and try the file once more.
4. Check that file and printer sharing, and network discovery, are enabled in the host's network settings.

How do you keep H103 from coming back?

Give the host a permanent address. Reserve its IP in the router, or set it statically, so the descriptor file never points at a machine that has moved. Keep hosting on one computer, and check the setting whenever QuickBooks is installed on a new PC. Rerun the Database Server Manager scan after every update or upgrade, since new versions install with new ports. Write the firewall exceptions down, so an IT change cannot remove them quietly. Last, open the file by server name and share rather than by a drive letter. Multi-user mode stays stable once these habits take hold.