QuickBooks Error 6189 is a QuickBooks Desktop company file access error. It often appears as Error -6189, -816 when QuickBooks cannot open the company file, especially in a multi-user setup.
The good news is that this error is often fixable without changing your accounting data. The risky part is guessing. If you delete the wrong file, open the wrong copy of the company file, or turn on hosting in the wrong place, you can make the problem harder to diagnose.
This guide explains what QuickBooks Error 6189 means, why it happens, and how to troubleshoot it in a safe order.
Table of Contents
Quick Answer
QuickBooks Error 6189 usually means QuickBooks Desktop cannot access the company file because of a file lock, damaged support file, network configuration problem, hosting conflict, or unsupported file location.
Start by closing QuickBooks on every computer, restarting the server first, updating QuickBooks Desktop, and running the tools in QuickBooks Tool Hub. If you use multi-user mode, also scan the company file folder with QuickBooks Database Server Manager and confirm that hosting is turned on only where it should be.
Important: This Is a QuickBooks Desktop Error
QuickBooks Online does not use a local .QBW company file, so QuickBooks Error 6189 is not a normal QuickBooks Online workflow issue. This article applies to QuickBooks Desktop for Windows, including Desktop company files opened locally or over a network.
QuickBooks Desktop for Mac uses different tools and does not follow the same Windows Tool Hub troubleshooting process.
What QuickBooks Error 6189 Means
In QuickBooks Desktop, your accounting data is stored in a company file that usually ends in .QBW. QuickBooks also uses supporting files to manage access and track activity. Two of the most important support files are:
- .ND file: A network descriptor file that helps QuickBooks locate and open the company file over a network.
- .TLG file: A transaction log file that tracks changes made to the company file.
When QuickBooks cannot properly read the company file, match it with the supporting files, or access it through the network path, Error 6189 may appear. In many cases, the company file itself is not lost. The problem is usually with access, locking, hosting, support files, permissions, or the file location.
Common Causes of QuickBooks Error 6189
| What you see | Likely cause | Where to focus |
|---|---|---|
| Error -6189, -816 appears when opening the company file | QuickBooks cannot access or validate the company file | Tool Hub, File Doctor, file location, .ND and .TLG files |
| File opens on the server but not on a workstation | Network path, workstation setup, or permissions issue | Database Server Manager, mapped drive, Windows permissions |
| File opens in single-user mode but fails in multi-user mode | Hosting or QuickBooks database service problem | Hosting settings and QuickBooks Database Server Manager |
| Error appears after moving the company file | Support files may not match the new location | Folder scan, .ND/.TLG recreation, correct file path |
| Error repeats when using a cloud-synced folder | Unsupported active file location or file locking conflict | Move the active file to a supported local or server folder |
Before You Start Troubleshooting
Do these checks before making changes. They reduce the chance of damaging data or troubleshooting the wrong file.
- Use a supported Windows computer for QuickBooks Desktop troubleshooting.
- Install the latest QuickBooks Desktop updates available for your version.
- Download and install the latest QuickBooks Tool Hub from Intuit.
- Sign in to Windows as an administrator when running repair tools.
- Ask all users to close QuickBooks before running tools or renaming support files.
- Find the exact company file location and confirm the file ends in .QBW.
- Make a backup copy before advanced troubleshooting.
- Get access to the server or host computer if the company file is shared in multi-user mode.
Important: Do not delete the .QBW company file. If you need to rename support files later, rename only the related .ND and .TLG files.
How to Fix QuickBooks Error 6189
Use the steps in this order. The sequence matters because Error 6189 can be caused by a simple file lock, a program issue, a damaged support file, or a multi-user network setup problem.
1. Close QuickBooks on all computers and restart in the right order
First, have every user close QuickBooks Desktop. If your company file is on a server or host computer, restart that computer first. After the server is back online, restart each workstation.
This clears temporary locks and stops stuck background processes that may be holding the company file open. It also gives the server a clean start before workstations try to reconnect.
After the restart, open QuickBooks Desktop and try the company file again. If the file opens normally, check that other users can also sign in if you use multi-user mode.
2. Update QuickBooks Desktop on every computer
Different QuickBooks Desktop release levels across workstations can contribute to file access and network issues. Update QuickBooks Desktop on the server or host computer and on each workstation that opens the company file.
If one workstation is behind on updates, the error may appear only on that computer. If every user gets the same error, continue with the server and company file troubleshooting steps below.
3. Run Quick Fix my Program from QuickBooks Tool Hub
Open QuickBooks Tool Hub and go to the Program Problems section. Run Quick Fix my Program.
This tool focuses on QuickBooks program components rather than the company file itself. It is a good early step because it is low-risk and can resolve program-level issues that prevent QuickBooks from opening the file properly.
Expected result: QuickBooks should close any affected background components and refresh the program. When it finishes, open QuickBooks Desktop and try the company file again.
If it does not work: Continue to File Doctor. Do not repeatedly run the same repair if the error returns immediately.
4. Run QuickBooks File Doctor
In QuickBooks Tool Hub, open the Company File Issues section and run QuickBooks File Doctor. Select the affected company file and choose the option that checks both file damage and network issues.
File Doctor can help with certain company file access problems and network configuration issues. It is especially useful when you are not sure whether the problem is with the file itself or how QuickBooks is reaching the file.
Expected result: File Doctor completes its scan and repair attempt. After it finishes, open QuickBooks Desktop and test the same company file.
If it does not work: Pay attention to whether the error affects one workstation or all workstations. One workstation usually points to a local computer, permission, or path problem. All workstations usually point to the server, hosting, Database Server Manager, or the file location.
5. Scan the company file folder with QuickBooks Database Server Manager
If the company file is shared over a network, open QuickBooks Database Server Manager from Tool Hub. Add or select the folder that contains the .QBW file, then scan that folder.
This step helps QuickBooks recreate or refresh the network access settings needed for multi-user mode. It also helps QuickBooks recognize the folder where the company file is stored.
Expected result: Database Server Manager should show the folder that contains the company file. After scanning, try opening the company file from a workstation.
If it does not work: Confirm that the file is stored in the correct shared folder and that the workstation is using the correct network path. If your office uses mapped drives, keep the mapping consistent, but also confirm that the server path works through Windows network access.
6. Check QuickBooks hosting settings
In a typical multi-user setup, hosting should be enabled on the server or host computer and disabled on regular workstations. If multiple workstations are trying to host the same file, QuickBooks may have trouble controlling access.
In QuickBooks Desktop, hosting settings are generally found under the File menu and Utilities. The exact wording may vary by version, but you are looking for options related to hosting multi-user access.
- On the server or host computer, hosting should be enabled if that machine shares the file.
- On regular workstations, hosting should usually be disabled.
- Do not turn on hosting on every computer just because the error appears in multi-user mode.
Expected result: Only the correct computer hosts the file. Then workstations connect to the file through the server or host computer instead of competing to manage access.
7. Rename the .ND and .TLG support files
If QuickBooks still shows Error 6189, the support files may be damaged or out of sync with the company file. Renaming them allows QuickBooks to create fresh support files the next time the company file opens.
Before doing this, make sure QuickBooks is closed on every computer.
- Open the folder that contains the company file.
- Find the files with the same company file name ending in .ND and .TLG.
- Rename each file by adding .OLD to the end of the file name.
- Do not rename or delete the .QBW company file.
- Open QuickBooks Desktop and try the company file again.
For example, if the support file is named CompanyName.qbw.ND, rename it to CompanyName.qbw.ND.OLD. Do the same for the related .TLG file.
Why this helps: The .ND file supports network access, and the .TLG file tracks changes. Renaming these files does not delete your accounting data. QuickBooks recreates them when the file opens successfully.
Expected result: New .ND and .TLG files appear in the folder after QuickBooks opens the company file.
8. Move the file out of unsupported locations
QuickBooks Desktop company files should be opened from a stable local hard drive or a supported network/server folder. Avoid using an active company file from a USB drive, removable drive, backup file, or consumer cloud-sync folder such as Dropbox, OneDrive, or Google Drive unless you are using an Intuit-supported hosting method.
Cloud sync tools can lock files, create conflicting copies, or sync changes while QuickBooks is trying to write to the database. That can trigger repeated access errors and create confusion about which file is current.
If the file is in an unsupported location, move the working company file to a proper local or server folder. Keep related files together in the same working folder where appropriate, and make sure all users open the same company file location going forward.
9. Check Windows permissions, firewall, antivirus, and services
If the error continues after the main QuickBooks tools and support file steps, look at the environment around QuickBooks.
- Make sure QuickBooks users have permission to read and write in the company file folder.
- Confirm that antivirus or firewall settings are not blocking QuickBooks network services.
- On the server, check that QuickBooks database services such as QuickBooksDBXX and QBCFMonitorService are running.
- Keep the company file path short and avoid unusual characters in folder names.
At this stage, the issue is often less about the QuickBooks file itself and more about how Windows, the network, or the server is allowing QuickBooks to access it.
How to Verify the Error Is Fixed
Do not stop troubleshooting just because the file opens once. Verify the setup so the error does not return during normal work.
| Check | How to verify | Expected result |
|---|---|---|
| Company file opens | Open the .QBW file from its normal location | No Error 6189 appears |
| Correct file location | Confirm the file path users are opening | Everyone uses the same active company file |
| Multi-user mode | Have more than one authorized user sign in if your company uses multi-user access | Users can work without file access errors |
| Database Server Manager | Review the scanned folders | The folder containing the company file is listed |
| Support files | Look in the company file folder after opening the file | New .ND and .TLG files are recreated |
| Hosting | Check hosting settings on the server and workstations | Only the correct host computer has hosting enabled |
Common Mistakes to Avoid
- Troubleshooting QuickBooks Online for this error: Error 6189 is a QuickBooks Desktop company file issue, not a normal QuickBooks Online workflow problem.
- Deleting the .QBW file: The .QBW file is your company file. Do not delete it while trying to fix support file problems.
- Renaming support files while QuickBooks is open: Close QuickBooks on all computers before renaming .ND or .TLG files.
- Turning on hosting everywhere: Hosting on multiple workstations can make access problems worse.
- Opening the file from a backup or USB drive: Restore or move the file to a proper working location before using it as the active company file.
- Ignoring release differences: Keep QuickBooks Desktop updated on the server and all workstations.
- Moving only one file without understanding related files: Keep the working company file environment organized so QuickBooks can recreate and use the files it needs.
When a Local Test Copy Helps
If you are trying to determine whether the issue is the company file or the network, a controlled test copy can help. Copy the company file to a local desktop folder on one computer and try opening it there. Use this only as a test, not as the new working file for everyone.
If the file opens locally but not from the network, the problem likely involves the server, network path, permissions, Database Server Manager, hosting, or security software. If the file fails locally too, focus more on the file and QuickBooks repair tools.
Warning: Do not let users start working in different copies of the same company file. That creates data confusion and can lead to missing transactions in the active records.
When to Get Professional Help
Basic Error 6189 troubleshooting is manageable for many businesses. Professional help makes sense when the error keeps returning, the file is used by multiple employees, the company file may be damaged, or the business cannot afford downtime while guessing through server and workstation settings.
You should also consider getting help if File Doctor reports serious data damage, users have opened different copies of the company file, or the company file is stored in a complicated network or hosted environment. At that point, the risk is not just inconvenience. It can affect access to current accounting records, payroll timing, invoicing, reporting, and period-end work.
Databrax can assist with QuickBooks Error Resolution, company file access problems, QuickBooks cleanup after file confusion, and support for related data issues when standard troubleshooting does not solve the problem.
FAQ
What is QuickBooks Error 6189?
QuickBooks Error 6189 is a QuickBooks Desktop error that appears when QuickBooks cannot access or open the company file. It commonly appears as Error -6189, -816 and is often connected to multi-user access, support files, hosting settings, or network configuration.
Does QuickBooks Error 6189 mean my company file is damaged?
Not always. The error can be caused by damaged support files, a locked file, incorrect hosting, Database Server Manager problems, Windows permissions, or an unsupported file location. File damage is possible, but it should not be assumed before checking access and network issues.
Can I delete the .ND and .TLG files?
It is safer to rename them instead of deleting them. Add .OLD to the end of each related .ND and .TLG file while QuickBooks is closed. QuickBooks can recreate these files when the company file opens. Do not delete or rename the .QBW company file.
Why does the file open on the server but not on a workstation?
That usually points to a workstation, network path, permissions, hosting, firewall, or Database Server Manager issue. The company file may be fine, but the workstation cannot reach it correctly through the network setup.
Should hosting be turned on for every QuickBooks workstation?
No. In a typical multi-user setup, hosting should be enabled only on the server or host computer that shares the company file. Regular workstations should usually have hosting disabled.
Can I keep my active QuickBooks Desktop file in OneDrive, Dropbox, or Google Drive?
Using a cloud-sync folder for the active QuickBooks Desktop company file can cause locking, syncing, and duplicate-copy problems unless you are using an Intuit-supported hosting method. A stable local drive or supported server folder is safer for day-to-day work.
What should I do if File Doctor does not fix Error 6189?
Next, check Database Server Manager, hosting settings, .ND and .TLG support files, the file location, Windows permissions, firewall settings, and QuickBooks database services. If the error persists or File Doctor reports serious damage, get professional support before continuing.
Is Error 6189 related to QuickBooks Online?
No. QuickBooks Online does not use local .QBW company files in the same way QuickBooks Desktop does. Error 6189 is a QuickBooks Desktop company file access issue.
Key Takeaways
- QuickBooks Error 6189 usually means QuickBooks Desktop cannot access the company file properly.
- The issue is commonly related to multi-user setup, file locks, .ND/.TLG support files, Database Server Manager, hosting, permissions, or file location.
- Restart the server first, then workstations, before moving into deeper troubleshooting.
- Use QuickBooks Tool Hub, Quick Fix my Program, File Doctor, and Database Server Manager in a safe order.
- Do not delete the .QBW company file, and do not host the file from every workstation.
- If the error affects all workstations, focus on the server and network setup. If it affects one workstation, focus on that computer’s path, permissions, and QuickBooks installation.
Conclusion
QuickBooks Error 6189 is frustrating because it blocks access to the company file, but it often comes down to a fixable access issue rather than lost accounting data. Start with the safest steps: close QuickBooks everywhere, restart in the right order, update QuickBooks, and use Tool Hub. Then check Database Server Manager, hosting, support files, file location, and permissions.
If the company file is part of a multi-user workflow, take extra care. A small hosting or file location mistake can affect every user. When the standard steps do not resolve the error, it is better to get help than to keep making changes that could complicate the file environment.
Need Expert Help with QuickBooks?
If QuickBooks Error 6189 is still preventing access to your company file, Databrax can help you troubleshoot the problem, review your multi-user setup, check company file access issues, and identify whether the problem is related to the file, server, workstation, or QuickBooks configuration. We can also assist with related QuickBooks cleanup or data support if file copies or access problems have created confusion in your records.