Handling issues with online license verification and license report submission
This article explains how to resolve Checkmk license issues by checking connectivity, proxy or firewall settings, and license credentials.
LAST TESTED ON CHECKMK 2.4.0P19
License Verification & Reporting Troubleshooting
If you experience issues or errors with online license verification and/or license report submission, please check the following things:
Check if you can reach license.checkmk.com using
curlas the site user from the host that is running your Checkmk site. See the following output as a reference, while your output might look different, you want to verify successful TLS connection and theHTTP/1.1 200 OK.OMD[mysite]:~$ curl -v https://license.checkmk.com/ * Host license.checkmk.com:443 was resolved. [...] * Connected to license.checkmk.com (2a0a:51c1:0:5::b) port 443 * ALPN: curl offers h2,http/1.1 * TLSv1.3 (OUT), TLS handshake, Client hello (1): * CAfile: /etc/ssl/certs/ca-certificates.crt * CApath: /etc/ssl/certs [...] * SSL connection using TLSv1.3 / TLS_AES_256_GCM_SHA384 / secp384r1 / RSASSA-PSS * ALPN: server accepted http/1.1 * Server certificate: * subject: CN=license.checkmk.com [...] * SSL certificate verify ok. * Certificate level 0: Public key type RSA (2048/112 Bits/secBits), signed using sha256WithRSAEncryption * Certificate level 1: Public key type RSA (2048/112 Bits/secBits), signed using sha256WithRSAEncryption * Certificate level 2: Public key type RSA (4096/152 Bits/secBits), signed using sha256WithRSAEncryption * using HTTP/1.x > GET / HTTP/1.1 > Host: license.checkmk.com > User-Agent: curl/8.5.0 > Accept: */* > [...] < HTTP/1.1 200 OK < Date: Wed, 07 Jan 2026 14:08:10 GMT [...] < * Connection #0 to host license.checkmk.com left intactIf you cannot reach it, try the following steps:
If your Checkmk server uses a proxy, from Checkmk 2.4.0p19 and above, you can configure an HTTP proxy in the Checkmk “Global Settings” and reference it in the license settings.
Check your firewall, proxy or other systems that may block this connection.
If it is intentionally blocked, then please refer to the “Manual transfer” in the Checkmk user guide.
Ensure that the license credentials you have entered are correct. If in doubt, create new credentials as described here.
Please make sure to click on “Confirm” after creating the credentials in the Odoo Customer Portal; otherwise, the credentials are not applied.
If you are on Checkmk Enterprise in 2.4 or lower, you need to click on “Submit license usage online” after entering the new licensing credentials in the product.If the issue persists, then please open a support ticket with us. Here is a description on how to raise a support ticket.