QuickBooks HelpQuickBooksHelpIntuit

Error H202: when hosting company file on a non-Windows Server

SOLVEDby QuickBooksUpdated 1 year ago

When opening a company file hosted on Fedora Linux or Citrix server, you get the error message:

Problem with multi-user hosting setup. QuickBooks could not open the file in multi-user mode. (H202)

This error occurs for one of the following reasons:

  • When the host name of the Fedora Linux server hosting the company file is set to its Fully Qualified Domain Name (FQDN). For example, [ComputerName].[DomainName].com.
  • You have a 64-bit version of Linux.

Fedora Linux

Important: The following solutions are intended to be used as a workaround to bypass broken Domain Name Settings (DNS) within Windows. If you are not comfortable with these steps or have questions relating to DNS settings, Intuit recommends you contact a qualified IT professional or refer to the Microsoft article.

Solution 1: Add the Server's Fully Qualified Domain Name to the hosts file of each QuickBooks workstation

The following steps must be performed on each workstation that is running QuickBooks.

  1. Open the etc folder:
    1. Click the Windows Start button and select All Programs > Accessories > Run.
    2. In the Open field, enter %SYSTEMROOT%\system32\drivers\etc and then click OK.
  2. Double-click the Hosts file.
  3. Under Programs, select Notepad, then OK.
  4. On the next available line, enter the Linux server's IP number. Press the Tab key on your keyboard, then enter the Linux server's Fully Qualified Domain Name.
  5. Choose File > Save.
  6. Choose File > Exit.

Solution 2: Edit the QBGlobalAppConfig.ini file on the Fedora Linux Server

  1. Open the Linux Terminal Window.
  2. Open the QBGlobalAppConfig.ini.
  3. Check the default range for ports and remove any spaces before and after the (=) equal sign.
    QuickBooks version...fromto...
    QuickBooks Desktop Enterprise 20.055388 = 555388=5
    QuickBooks Desktop Enterprise 19.055383 = 555383 = 5
    QuickBooks Desktop Enterprise 18.055378 = 555378 = 5
    QuickBooks Desktop Enterprise 17.055373 = 555373 = 5

    You can find the complete list of ports in Install Linux Database Server Manager.

  4. Save the QBGlobalAppConfig.ini file.
  5. Stop and restart the QBDBFILEMON and QBDBMGRN services.

Solution 3: Create a mapped drive

Create a mapped drive to the Linux server's IP address.

If you still see the error, go to How to fix error H202 and H505. 


This error occurs when the Citrix server is publishing QuickBooks using client-side application virtualization.

Solution: Run QuickBooks using server-side application virtualization

Because of the complexity and number of available Citrix server configurations, Intuit cannot provide support for each server configuration issues. If you need further assistance with Citrix server setup, check with your system or network administrator or a local computer consultant.

Was this helpful?

You must sign in to vote, reply, or post
QuickBooks DesktopQuickBooks Desktop PremierQuickBooks Enterprise Accountant

Sign in for the best experience

Ask questions, get answers, and join our large community of QuickBooks users.

More like this