OnCallSolve

How to Fix QuickBooks Error H505

Error H505
Hard
~35 min
QuickBooks Error Guide
How to Fix QuickBooks Error H505
James Whitfield
Written by

James Whitfield

Small Business Technology Journalist
Kevin Marsh

Reviewed byQuickBooks ProAdvisor Level 3

Published: Mar 9, 2026Updated: Mar 9, 2026

Key Takeaways
  • Error H505 occurs when a workstation cannot reach the QuickBooks Database Server Manager on the host computer
  • The most common causes are incorrect hosting configuration, blocked firewall ports, and damaged .ND files
  • Disabling hosting on all workstations (and enabling it only on the server) resolves the majority of cases
  • Running QuickBooks Database Server Manager via the QuickBooks Tool Hub fixes .ND file and firewall permission issues
  • All fixes must be applied on the host computer (the machine where the company file is stored), not on workstations

QuickBooks Error H505 is a multi-user hosting error that prevents workstations from connecting to a shared company file on the network. It appears when switching to multi-user mode and indicates that QuickBooks cannot communicate with the host computer running the Database Server Manager. This guide covers all fixes verified on QuickBooks Desktop 2022 through 2026 on Windows 10 and Windows 11. Left unresolved, it blocks your entire team from accessing the company file simultaneously.

Need help? Call our support line.

A support agent can walk you through the fix step by step.

+1 (800) 446-8848

What Is QuickBooks Error H505?

QuickBooks Error H505 belongs to the H-series of multi-user errors, a group that includes H101, H202, H303, and H505. These errors share a common cause: QuickBooks on a workstation cannot establish a connection to the host computer that holds the shared company file.

When Error H505 appears, you typically see this message on screen:

"QuickBooks needs to be closed as there is a problem. Sorry for the inconvenience caused."

The error surfaces specifically when switching to multi-user mode, because that is when QuickBooks tries to connect across the network to the Database Server Manager service running on the host. If that handshake fails for any reason, including misconfigured hosting, blocked ports, damaged network descriptor files, or stopped services, H505 is the result.

Symptoms

You may be experiencing Error H505 if you notice:

  • The error message appears immediately when attempting to switch to multi-user mode
  • QuickBooks crashes or freezes on workstations while the host continues to work normally
  • Only one user can open the company file at a time (single-user mode works, multi-user fails)
  • The system becomes sluggish or unresponsive when QuickBooks tries to connect to the host
  • The error affects some workstations but not others on the same network

Root Causes

1. Incorrect Hosting Configuration

Multi-user mode requires hosting to be enabled only on the server (the host machine where the company file lives). If any workstation also has hosting enabled, it creates a conflict that triggers H505. This is the most frequent cause.

2. Damaged or Missing .ND File

QuickBooks uses a Network Descriptor (.ND) file, stored alongside the company file, to locate the host computer on the network. If this file is corrupted, missing, or contains an outdated IP address, workstations cannot find the server.

3. QuickBooks Services Not Running

Two Windows services must be active on the host computer:

  • QuickBooksDBXX (XX = your QB version year, e.g., QuickBooksDB33 for QB 2023) manages multi-user database connections
  • QBCFMonitorService monitors company file access across the network

If either service has stopped, multi-user connections fail immediately.

4. Firewall Blocking QuickBooks Ports

Windows Firewall or third-party security software may block the ports QuickBooks uses for multi-user communication. QuickBooks requires specific inbound and outbound ports to be open depending on your version.

Need help? Call our support line.

A support agent can walk you through the fix step by step.

+1 (800) 446-8848

5. Wrong DNS Settings or IP Address

If the host computer's IP address has changed (common in networks without static IP assignment) and the .ND file still references the old address, workstations cannot locate the host.

Before You Begin

  • Confirm which computer is the host (the one where the company file is stored and where Database Server Manager is installed)
  • Ensure you have administrator privileges on the host computer
  • Make a note of your QuickBooks Desktop version year (e.g., 2022, 2023), as you will need it in several steps
  • Back up the company file before making any system-level changes
  • Complete all steps on the host computer first, then test from the workstations

Step-by-Step Fix

Work through these methods in order. Most cases are resolved by Method 1 or Method 2.

Method 1: Correct the Hosting Configuration

Hosting must be ON only on the server and OFF on all workstations.

On each workstation (not the server):

  1. Open QuickBooks Desktop
  2. Go to File > Utilities
  3. If you see "Stop Hosting Multi-User Access", click it to turn hosting off on this workstation
  4. If you see "Host Multi-User Access", hosting is already off; no action needed
  5. Repeat on every workstation connected to the company file

On the host/server computer:

  1. Open QuickBooks Desktop
  2. Go to File > Utilities
  3. If you see "Host Multi-User Access", click it to enable hosting on the server
  4. If you see "Stop Hosting Multi-User Access", hosting is already on; no action needed

After correcting the hosting configuration, test multi-user access from a workstation. If Error H505 persists, continue to Method 2.

Method 2: Run QuickBooks Database Server Manager (Tool Hub)

The QuickBooks Tool Hub's Database Server Manager rescans your company file, repairs the .ND file, and refreshes firewall permissions in a single operation.

  1. Download the latest QuickBooks Tool Hub from the official Intuit support page
  2. Run the installer (QuickBooksToolHub.exe) and follow the on-screen prompts
  3. Accept the license agreement and complete the installation
  4. Open QuickBooks Tool Hub from the Windows desktop icon
  5. Click Network Issues in the left panel
  6. Click QuickBooks Database Server Manager
  7. Click Browse and navigate to the folder containing your company file (.qbw)
  8. Click Start Scan
  9. Wait for the scan to complete. It will automatically repair the .ND file and update firewall rules
  10. Click Close when the scan finishes
  11. Open QuickBooks on each workstation and switch to multi-user mode to test

Method 3: Verify QuickBooks Services Are Running

These steps must be performed on the host computer.

  1. Press Windows + R, type `services.msc`, and press Enter
  2. In the Services window, scroll down to find QuickBooksDBXX (use this mapping: QuickBooksDB36 = 2026, QuickBooksDB35 = 2025, QuickBooksDB34 = 2024, QuickBooksDB33 = 2023, QuickBooksDB32 = 2022)
  3. Right-click it and select Properties
  4. Set Startup type to Automatic
  5. If the service is not running, click Start
  6. Click the Recovery tab, set First failure to Restart the Service, then click OK
  7. Repeat steps 2 through 6 for QBCFMonitorService
  8. Close the Services window and test multi-user access

If QuickBooksDBXX does not appear in the Services list, QuickBooks Database Server Manager is not installed on the host. Download and install it via the QuickBooks Tool Hub (see Method 2).

Method 4: Configure Windows Firewall Exceptions

Firewall rules blocking QuickBooks ports are a common cause of H505 when Methods 1 through 3 do not resolve the issue.

Add QuickBooks as a firewall exception:

  1. Open Control Panel > System and Security > Windows Defender Firewall
  2. Click Allow an app or feature through Windows Defender Firewall
  3. Click Change Settings (requires administrator privileges)
  4. Click Allow another app
  5. Browse to and select `QBDBMgrN.exe` (Database Manager), `QBW32.exe` (QuickBooks), and `QBCFMonitorService.exe`
  6. Ensure both Private and Public checkboxes are checked for each program
  7. Click OK

Open specific ports (if exception list does not resolve the issue):

The ports required depend on your QuickBooks version. Refer to the official Intuit firewall guide for the complete port list.

To add a port rule:

  1. In Windows Defender Firewall, click Advanced settings
  2. Right-click Inbound Rules and choose New Rule
  3. Select Port and click Next
  4. Select TCP, enter the port number(s), and click Next
  5. Select Allow the connection and click Next
  6. Apply to all profiles (Domain, Private, Public) and click Next
  7. Name the rule (e.g., "QuickBooks Multi-User") and click Finish
  8. Repeat for Outbound Rules

Method 5: Edit the Windows Hosts File

If the host computer's IP address has changed, you can manually update the hosts file so workstations can resolve the server correctly.

Step 1 - Get the host computer's IP address:

  1. On the host computer, press Windows + R, type `cmd`, and press Enter
  2. Type `ipconfig /all` and press Enter
  3. Note the IPv4 Address under your active network adapter

Step 2 - Edit the hosts file on each workstation:

  1. Close QuickBooks on the workstation
  2. Navigate to `C:\Windows\System32\Drivers\etc\`
  3. Right-click the `hosts` file and open it with Notepad (run as administrator)
  4. Add a new line at the bottom in this format: `[host-IP-address] [host-computer-name]`
  5. Save the file and close Notepad
  6. Repeat on all workstations, then test multi-user mode
Need help? Call our support line.

A support agent can walk you through the fix step by step.

+1 (800) 446-8848

Method 6: Move the Company File to a New Folder

A corrupted folder path can prevent QuickBooks from establishing multi-user connections even when all settings are correct.

  1. On the host computer, create a new folder (e.g., `C:\QBCompanyFiles\`)
  2. Right-click the new folder, select Properties > Security
  3. Ensure the QuickBooks user account has Full Control permissions
  4. Copy your company file (.qbw) into the new folder
  5. Open QuickBooks on the host, go to File > Open or Restore Company
  6. Browse to the new folder and open the company file
  7. Switch to multi-user mode and test access from workstations

When to Call Support

Contact Intuit Support directly if:

  • Error H505 persists after completing all six methods above
  • The error appears only on specific operating systems (indicating a compatibility issue with a newer Windows update)
  • You see additional error codes alongside H505 (such as 6000-series errors), which indicate database corruption
  • Your QuickBooks version is more than three years old and incompatible with current Windows updates

You can reach Intuit support through the QuickBooks Contact page or the Help menu inside QuickBooks Desktop.

Prevention Tips

  • Assign a static IP address to the host computer to prevent the .ND file from becoming outdated when DHCP reassigns addresses
  • Keep QuickBooks updated. Intuit releases patches that include firewall rule updates; apply them promptly via Help > Update QuickBooks Desktop
  • Schedule monthly service checks. Open Services (services.msc) on the host monthly to confirm QuickBooksDBXX and QBCFMonitorService are running with Automatic startup
  • Train users not to enable "Host Multi-User Access" on their workstations. Remind the team that hosting belongs only on the server
  • Run the Tool Hub Network Scan quarterly to refresh .ND files and firewall permissions proactively before errors surface
Expert Insight

In my experience supporting hundreds of QuickBooks Desktop installations, Error H505 is almost always a hosting configuration problem. Someone has enabled hosting on a workstation by accident, or the QuickBooks services stopped after a Windows update. My first check is always File > Utilities on every machine in the office. If that does not resolve it within minutes, the Tool Hub Network Scan fixes 90% of remaining cases by regenerating the .ND file and correcting firewall rules automatically. The hosts file edit is a last resort for networks without static IP assignment, and it is worth doing permanently to prevent recurrence.

James Whitfield

James Whitfield

Small Business Technology Journalist

H-Series Error Comparison

All four H-series errors share the same root causes but differ in what the workstation can and cannot detect. Use this table to confirm you are troubleshooting the right error.

ErrorWhat It MeansMost Common CauseFirst Fix
H101Workstation cannot find the host at allHosting not enabled on server, or wrong IP in hosts fileEnable hosting on server (Method 1)
H202Workstation finds host but connection is refusedFirewall blocking ports, or QBCFMonitorService stoppedRun Tool Hub Network Scan (Method 2)
H303Company file cannot be opened on the hostDamaged .ND file or wrong file pathRun Tool Hub Network Scan (Method 2)
H505Workstation detects host but cannot complete handshakeHosting enabled on a workstation (conflict)Disable hosting on all workstations (Method 1)

The fix steps for all four errors overlap significantly. If you followed this guide and still see errors, check whether the error code has changed. A different H-series code after fixing H505 indicates partial progress and points to a new specific cause.

Get Support

The fastest way to resolve a QuickBooks issue is to speak directly with a support agent. Below you'll find the verified QuickBooks customer service phone number, current support hours, average wait time, and the best time to call to avoid long holds.

Phone Number

+1 (800) 446-8848

Support Hours

Mon–Fri, 6am–6pm PT

Avg Wait Time

~8 minutes min

Best Time

Early morning weekdays (6am–8am PT)

Conclusion

QuickBooks Error H505 is frustrating but fixable in most cases without advanced technical knowledge. The root cause is almost always a hosting misconfiguration or a stopped Windows service, both of which the six methods above address directly. Start with Method 1 (hosting configuration check) and Method 2 (Tool Hub Network Scan) as they resolve over 90% of cases. If the error returns after some time, check whether a Windows Update reset your firewall rules or a DHCP change altered the server's IP address. Keeping the host on a static IP and running quarterly Tool Hub scans will prevent most recurrences.

Sources & References

Disclaimer: OnCallSolve is an independent support directory. We are not affiliated with, endorsed by, or sponsored by Intuit, QuickBooks, or any software company mentioned in this article. All product names, logos, and brands are property of their respective owners. This article is provided for informational purposes only.


About Our Contributors
James Whitfield
Written by
James Whitfield

Small Business Technology Journalist

James Whitfield is a small business technology journalist and former Intuit customer support specialist with over a decade of hands-on experience with QuickBooks products. He spent three years on Intuit's Tier 2 technical support team before moving into full-time tech journalism, where he covers accounting software, financial tools, and productivity apps for small business owners. James has written more than 400 troubleshooting guides and software comparison articles, with a focus on QuickBooks Desktop errors, installation issues, and data migration. He holds a B.A. in Communications from the University of Michigan and is based in Chicago, Illinois.


Kevin Marsh

Reviewed by

QuickBooks ProAdvisor Level 3

Kevin Marsh is a Certified Public Accountant with 20 years of experience in public accounting and financial systems consulting. He holds a QuickBooks ProAdvisor Level 3 certification — the highest tier offered by Intuit — and has trained more than 300 accountants and business owners on QuickBooks Desktop and Online. Kevin is a partner at Marsh & Associates CPA Group in Denver, Colorado, where he leads the firm's technology advisory practice. He served on Intuit's ProAdvisor Advisory Council from 2018 to 2022 and has been quoted as a QuickBooks authority in Accounting Today and CPA Practice Advisor. Kevin reviews all QuickBooks content on OnCallSolve to ensure technical accuracy, correct step sequencing, and compliance with current Intuit product versions.

Frequently Asked Questions

All four belong to the H-series of multi-user errors and share similar causes including hosting misconfiguration, blocked ports, and stopped services. H505 specifically indicates that QuickBooks on the workstation can detect the host computer but cannot complete the connection, often because hosting is improperly enabled on the workstation itself. H202 is the most common of the group. The fix steps overlap significantly across all four.

No. Error H505 is a network connectivity error. It prevents access to the company file but does not modify or damage it. Your data remains intact on the host computer. Always back up before troubleshooting as a precaution, but H505 itself is not a data-loss risk.

If other workstations connect successfully in multi-user mode, the issue is specific to that one machine. The most likely causes are: hosting is accidentally enabled on that workstation (check File > Utilities), the hosts file on that workstation has an outdated IP address for the server, or the local Windows Firewall on that workstation is blocking the QuickBooks ports.

Yes. After any configuration change, including hosting settings, services restart, firewall rules, or hosts file edits, close QuickBooks completely on all machines and reopen it before testing multi-user mode. A full restart ensures QuickBooks re-reads all network settings.

Reinstalling QuickBooks on a workstation rarely fixes H505 because the error is caused by network and service configuration, not by the QuickBooks installation files themselves. Complete the methods in this guide first. If all else fails, reinstalling QuickBooks Database Server Manager on the host (not the workstations) may help.

Yes. VPNs can interfere with the network communication QuickBooks requires for multi-user mode. If your team uses a VPN to connect to the office network remotely, ensure the VPN is configured to allow LAN traffic and that the QuickBooks ports are not blocked at the VPN firewall level. QuickBooks Desktop is designed for local network use; remote access over VPN may require additional configuration.

The service name maps directly to your version year: QuickBooksDB36 (2026), QuickBooksDB35 (2025), QuickBooksDB34 (2024), QuickBooksDB33 (2023), QuickBooksDB32 (2022), QuickBooksDB31 (2021). If you are unsure of your version, open QuickBooks Desktop and go to Help > About QuickBooks to see the full version number.

The most common triggers for a recurrence are: a Windows Update that reset firewall rules, a DHCP lease renewal that changed the host computer's IP address, or QuickBooks services being stopped by a system restart that did not bring them back online. Run through Method 1 (hosting check) and Method 3 (services check) first; they resolve the majority of recurrences.

Was this article helpful?