Knowledgebase
[QODBC-Desktop] - Subscription License Lost After Upgrading to QODBC v24: Downgrade to v23 Required
Posted by William - QODBC Support on 19 October 2026 11:36 AM

[QODBC-Desktop] - Subscription License Lost After Upgrading to QODBC v24: Downgrade to v23 Required

Problem Description:

After upgrading from QODBC version 23 to version 24 (the subscription-based release), existing CDKey-based licenses stop working. Attempting to deactivate or activate the CDKey produces one of the following errors:

Error

"Activation not on file for CDKey: XXXX-XXXX-XXXX-XXXX"

Error

"Auto license switch failed. No recent health check record found for the machine <hostname>. Please deactivate the CDKey: XXXX-XXXX-XXXX-XXXX (Auto)"

Error

"The CDKEY entered does not correspond to the product "QRemote Desktop" and could be for another product. CDKey has an invalid checksum."

The QODBC driver enters an evaluation (unlicensed) state. When the QRemote Server runs, it reports:

Error

"No QODBC license found. A fully licensed (CDKEY) version of QODBC is required"

Affected products: QODBC Desktop v24+, QRemote Desktop, QuickBooks Enterprise (bundle/read-only editions)
Expected outcome: Downgrading to the last subscription-compatible version restores the CDKey activation path.

Symptoms:

  • The upgrade from QODBC v23 to v24 was performed (often triggered automatically by a QuickBooks Desktop or operating system update).
  • The CDKey no longer activates - it is "not on file" under the new licensing system.
  • QRemote Server crashes or refuses connections due to a missing license.
  • A bundle version of QODBC (free Read-Only edition for QuickBooks Enterprise) lacks a QRemote license entirely; connecting via QRemote requires purchasing a separate QRemote upgrade.

Cause:

QODBC v24 introduced a new subscription licensing and activation system. The old CDKey-based licenses are not compatible with this version - the key cannot be registered on the new server. When QODBC v24 is installed, the previous license becomes orphaned, and the driver falls back to evaluation mode.

The upgrade path (v23 → v24) requires purchasing a new subscription. The only way to use an existing CDKey is to remain on the last version of QODBC that supports that CDKey.

Environment:

ProductVersion / Detail
QODBC Desktop v24 and later (subscription version)
Previous version v23 (CDKey-based, last compatible version)
QRemote Server All versions - requires a valid QRemote license in addition to the core QODBC license

Solution:

The fix requires two steps: downgrading to a compatible version, then activating with the existing CDKey.

  1. Download QODBC v23 (the last CDKey-compatible version).
    Download from: QODBC Desktop download page
  2. Uninstall QODBC v24 completely.
    Remove the current installation via Control Panel → Programs and Features → uninstall QODBC Driver for QuickBooks (v24). Restart the machine afterward.
  3. Install QODBC v23.
    Run the downloaded installer. When prompted to enter a CDKey during setup, skip this step - complete the installation first.
  4. Activate the license manually.
    Open Control Panel → Administrative Tools → Data Sources (ODBC) (32-bit):
    1. Select System DSN, highlight QuickBooks Data, and click Configure.
    2. Navigate to the Activate/Deactivate tab and select Activate.
    3. Enter the existing CDKey and click Activate.
  5. Reboot the machine.
    This ensures all ODBC settings and the QRemote Server pick up the new license state.
  6. Verify the activation.
    Open the QODBC Test Tool and confirm a successful connection. The QRemote Server should no longer report a missing license.

QRemote Bundle / Read-Only Edition Note

If you have the free Read-Only bundle edition of QODBC for QuickBooks Enterprise, this version does not include a QRemote license. To use QRemote, purchase a separate upgrade:
QODBC Purchase Page or Contact Sales

Additional Notes:

  • Do not skip reboots. Both the ODBC registry changes and QRemote license initialization require a restart to take effect.
  • v23 downloads are no longer on the front page. They may be retrieved from the builds archive or by contacting support.
  • CDKey reset. If the CDKey itself is invalid or unrecognized, contact QODBC Support to have it reset for v23 compatibility.
  • "Invalid Checksum" on new purchase. If you recently purchased a QODBC 2024 subscription and receive "CDKey has an invalid checksum" when activating on an older version of QODBC, this is expected - the key is for v24+ only. Install QODBC v24+ before activating.

How to Deactivate QODBC and How to Transfer the License to a New Computer How to Activate QODBC QODBC and Remote Licensing Information

Keywords:

CDKey Subscription License QODBC v24 QODBC v23 Downgrade Activation Not on File Invalid Checksum QRemote License Evaluation Mode Read-Only Bundle QuickBooks Enterprise Reboot Required System DSN Activate
(0 vote(s))
Helpful
Not helpful

Comments (0)
Post a new comment
 
 
Full Name:
Email:
Comments:
CAPTCHA Verification 
 
Please complete the captcha below (we use this to prevent automated submissions).