Skip to content
Syntra ODBC Home

QuickBooks Crash Recovery

Syntra ODBC can automatically bring QuickBooks Desktop back online after a crash, reopen the configured company file, and reconnect its QuickBooks session without waiting for you to do it manually.

This is a Windows desktop recovery feature for the Syntra app itself. It is designed for unattended or semi-attended QuickBooks workstations where a crash would otherwise leave the machine stuck on a modal dialog.

What It Can Recover

Section titled “What It Can Recover”

When recovery is enabled, Syntra can handle the standard QuickBooks Desktop crash flow:

  • dismiss the QuickBooks - Unrecoverable Error dialog
  • dismiss the follow-up QuickBooks is now terminating dialog
  • reopen the configured .QBW file
  • handle a username + password login prompt
  • handle a password-only login prompt
  • handle the No Company Open state and reopen the configured company
  • reconnect Syntra to QuickBooks after the company is back online

What You Need To Configure

Section titled “What You Need To Configure”

Open Syntra ODBC and go to Settings > QuickBooks.

Set these fields:

  1. Company file Use the full absolute path to the .QBW file you want Syntra to reopen after a crash.
  2. Crash recovery Turn on Auto-recover QuickBooks after a crash.
  3. QB login user Fill this only if your QuickBooks login prompt asks for a username.
  4. QB login password Fill this if your QuickBooks company file requires a password at login.

You can also set the same values in config.toml:

[quickbooks]
company_file = "C:\\Path\\To\\Company.qbw"


[quickbooks.recovery]
enabled = true
# username = "Admin"
# password = "your-password"

How Recovery Works

Section titled “How Recovery Works”

Syntra watches for crash-like QuickBooks states instead of relying only on whether QBW.EXE still exists. That matters because QuickBooks often stays visible while a crash dialog is waiting for confirmation.

When Syntra detects that state, it:

  1. stops sending new QuickBooks requests
  2. releases its existing QuickBooks session
  3. dismisses the standard crash dialogs
  4. reopens the configured company file
  5. submits the login prompt if one appears
  6. reconnects the QuickBooks session

Requirements

Section titled “Requirements”
  • QuickBooks Desktop and Syntra must be running under the same Windows user session.
  • company_file must be configured for deterministic reopen.
  • Syntra must already be authorized in QuickBooks under Edit > Preferences > Integrated Applications.
  • If you run Syntra as a Windows service, the service account must match the Windows user that is authorized in QuickBooks. See Windows Service.

Limits

Section titled “Limits”
  • This feature is for the standard QuickBooks crash and login dialogs Syntra currently knows how to classify.
  • If QuickBooks shows a new or unusual modal window, recovery may still require manual intervention until Syntra learns that dialog shape.
  • The feature does not remove the need for normal backups and company-file maintenance.

Troubleshooting

Section titled “Troubleshooting”

If recovery does not bring the company back online:

  1. Verify that Company file points to the exact .QBW you want reopened.
  2. Confirm the QuickBooks login fields in Syntra match the actual company login prompt.
  3. Check %ProgramData%\\SyntraODBC\\logs\\syntra.log for recovery messages and errors.
  4. If QuickBooks still opens to No Company Open, re-check the configured path and make sure that file is accessible to the current Windows user.

For broader setup and runtime issues, see Common Issues.