- Setting Up a Network or Multi-User Environment
- Error H101, H202, H303, or H505 when opening your company file to resolve multi-user issues
The term hosting is used to describe the situation where the computer that is storing a company file (the host) allows other computers to access the file.
QuickBooks uses a service to manage company file access:
- QuickBooks 2018 uses QuickBooksDB28
- QuickBooks 2017 uses QuickBooksDB27
- QuickBooks 2016 uses QuickBooksDB26
- QuickBooks 2015 uses QuickBooksDB25
The following diagrams illustrate QuickBooks Desktop hosting modes.
How company files are accessed
- Windows File permissions: The user who is logged in must have permissions set to Full control, which includes permission to look at, open, and modify the file.
- Database Server mode: The database server can successfully open the company file.
- QuickBooks User login: Each user must have a QuickBooks user login and password.
- Once these 3 requirements are met, you can access the company file.
There are 3 hosting modes: Not Hosting (also known as Hosting Off), Hosting Local Files only, and Hosting Local & Remote files.
In Not Hosting mode
- QuickBooks Database Manager runs as a normal process, as a Windows user running QuickBooks Desktop.
- Not Hosting mode does not support multi-user mode. Not Hosting mode uses shared memory to communicate with QuickBooks Desktop. In this mode, only the QuickBooks Desktop user who is running QuickBooks Desktop on the local computer can use a database server to access a file.
In Hosting Local Files only mode
- QuickBooks Database Server Manager runs as a Windows service named QuickBooksDBXX (where XX is a number from 25 to 28 determined by the version of QuickBooks Desktop, as described under "Hosting defined," above) and as the Windows user QBDataServiceUserXX (with XX being the same 2-digit number from 25 to 28 that the Windows service uses).
- As long as the computer is on, the service QuickBooksDBXX is always running.
- Multi-user mode is supported, using TCP/IP to communicate with QuickBooks Desktop. QuickBooks Desktop users on remote computers can access company files using a database server running in Hosting Local Files only mode.
- A computer in Hosting Local Files only mode can host only those files that are located on that computer.
In Hosting Local & Remote files mode:
- QuickBooks Database Manager runs as a normal process, as the currently logged on Windows user. This process starts when a user logs in to Windows and stops when the user logs out.
- A computer in Hosting Local & Remote files mode can support multi-user mode, using TCP/IP to communicate with QuickBooks Dekstop. QuickBooks Desktop users on remote computers can access company files on this computer using a database server.
- A local computer in this mode can host files stored on it, as well as files that are located on remote computers and opened on the local computer.
How QuickBooks Desktop determines which database server to communicate with
- QuickBooks Desktop looks for the .nd file. The .nd file is a small text file with the same name as the company file, but with an .nd file extension. This file is located in the same directory as the company file, which has the file extension .qbw. The directory also contains the information needed to contact the server, such as the IP address and port.
- QuickBooks Desktop determines whether the .qbw file is in use.
- If QuickBooks Desktop finds the .nd file and detects that the company file is in use, QuickBooks Desktop tries to communicate with the server:
- If it is successful, QuickBooks Desktop opens the company file.
- If it's not successful, an error message that describes the steps needed to resolve the issue appears. See Error H101, H202, H303, or H505 when opening your company file.