Help Centre

Getting started, frequently asked questions, and known limitations for the Chainlook TLS Certificate Chain Checker.

Getting started

What Chainlook does

Paste a hostname. Chainlook opens a real TLS connection to that server, reads the certificate chain it actually presents, and reports — in plain language — the expiry date and days remaining, who issued it, every hostname the certificate covers, and whether the chain is complete from leaf to a trusted root.

To check a certificate:

  1. Go to the App page.
  2. Type a hostname into the input field (e.g. github.com). Hostnames only — IP addresses are not supported.
  3. Click Check.
  4. Review the results: expiry status, issuer, SAN coverage, chain structure, and a completeness verdict.

No account needed. No sign-up. Each check is stateless — results are displayed in your browser and discarded when you leave the page.

Frequently Asked Questions

What does "chain completeness" mean and why should I care?

A TLS certificate chain starts with your server's leaf certificate and links through one or more intermediate certificates to a trusted root. Some servers — especially those configured with older tools — send only the leaf certificate, omitting the intermediate CA certificate(s).

Browsers on desktop often work anyway because they cache intermediate certificates from previous visits. Mobile clients and fresh browser profiles do not have that cache. The result: your site loads fine for you, and it fails for someone visiting it for the first time on a phone. Chainlook flags this gap as an incomplete chain so you can fix it before it becomes an outage.

Can I check a certificate by IP address?

No. Chainlook accepts hostnames only — for example github.com, www.example.com, or api.stripe.com. IP addresses are not supported because the TLS connection verification and certificate Subject Alternative Name comparison are hostname-based.

Why does Chainlook say my server is unreachable when it works fine in my browser?

There are a few common reasons:

  • Behind Cloudflare: Chainlook runs on Cloudflare Workers. A Cloudflare Worker cannot open a TCP connection to another host that is also behind Cloudflare — the platform blocks it. The tool will report the target as unreachable, which is a platform limitation, not a problem with your server.
  • Port filtering: Chainlook checks port 443 only. If your server listens on a different port, the connection will be refused.
  • IP-restricted access: If your server allows connections only from specific IP ranges (e.g. your office or a VPN), the Worker's IP may be blocked.
Can Chainlook send me alerts or reminders when my certificate is about to expire?

No. Chainlook is a diagnostic tool — it answers when you ask it. There is no email sender, no alerting system, no daemon, and no scheduled re-check. The tool does not monitor, watch, or notify you about anything. If you need expiry monitoring, consider a dedicated certificate lifecycle management service — Chainlook is not one.

Is there an API I can use to automate certificate checks?

Not yet. An API is planned as part of the Pro tier, but it has not been built. Today the only interface is the web form on the App page.

Can I check multiple hostnames at once?

No. The free tool accepts one hostname per check. Batch checks (up to 10 hostnames per run) are planned for the Pro tier, which is not yet available.

What do the error messages mean?

Chainlook distinguishes several failure modes so you can tell what actually went wrong:

  • Timeout — The server did not respond within the connection window. Possibly a firewall, a routing issue, or the host is down.
  • DNS failure — The hostname could not be resolved to an IP address. Check that the DNS record exists and is correctly configured.
  • Connection refused — The server actively rejected the connection. Port 443 may not be open, or an ACL is blocking the Worker's IP.
  • Cloudflare limitation — The target is likely behind Cloudflare, and the Worker cannot reach it. This is not a problem with the server itself.
  • TLS handshake failure — The server responded but the TLS handshake failed (e.g. protocol mismatch, bad cipher, expired certificate on the server).
What port does Chainlook check?

Port 443 only. There is no way to specify a custom port. This is a limitation of the current implementation.

Known limitations

Chainlook is a focused diagnostic tool. Some features you might expect from a commercial TLS monitoring service are deliberately absent or not yet built. These are the current limitations:

No alerts, reminders, or scheduled checks

Chainlook does not monitor certificates. It has no email sender, no cron-based re-check, no push notifications, and no dashboard. Every check is manual and stateless. If you need continuous monitoring, Chainlook is not the right tool for that use case.

Cloudflare-hosted targets cannot be reached

Because Chainlook runs on Cloudflare Workers, it cannot open a TCP connection to another host behind Cloudflare. Targets behind Cloudflare will always be reported as unreachable. This is a platform limitation of the Workers runtime, not a finding about your server.

Port 443 only — no custom port support

Every check targets port 443. Servers that serve HTTPS on a non-standard port cannot be checked.

Hostname-only — no IP address support

You must enter a hostname. IPv4 and IPv6 addresses are not accepted.

No accounts, no history, no state

Every check is independent. Check results are not saved, logged, or stored. There is no account system, no check history, and no way to review past results. If you reload the page, previous results are gone.

Pro features are planned, not built

Batch checks, JSON/CSV exports, API access, and the Pro subscription plan are on the roadmap but have not been implemented. The Pro pricing page and checkout form are demonstrations only — no payment is processed and no subscriptions are created.

Contact & support

Chainlook is maintained by a small team. Support is handled through this Help Centre — the information on this page covers the most common questions and known issues.

Routine questions — If you cannot find an answer on this page, review the Terms of Service and Privacy Policy for further details about how the tool operates.

Feature requests & bug reports — These are reviewed periodically by the operator. There is no public issue tracker or support ticket system at this time.

Urgent / escalation — If you are experiencing a problem that suggests a security issue with the tool itself, or a matter requiring the operator's direct attention (e.g. takedown requests, legal notices), the issue will be escalated to the owner.

Escalation: owner-on-call — not for routine questions