Skip to content

fix: Use TLS dial for HTTPS healthchecks to prevent handshake warnings#199

Merged
leggetter merged 1 commit intomainfrom
fix/healthcheck-https
Feb 3, 2026
Merged

fix: Use TLS dial for HTTPS healthchecks to prevent handshake warnings#199
leggetter merged 1 commit intomainfrom
fix/healthcheck-https

Conversation

@leggetter
Copy link
Collaborator

Summary

  • Fixes the TLS handshake warnings reported in TLS handshake warnings on local webserver triggered by Hookdeck CLI #198 by using proper TLS connections for HTTPS healthchecks
  • The healthcheck was using raw TCP connections which caused incomplete TLS handshake warnings on servers with self-signed certificates
  • Adds --no-healthcheck flag as an escape hatch to disable health monitoring entirely

Changes

  • Healthcheck TLS support: Use tls.DialWithDialer for HTTPS endpoints with InsecureSkipVerify respecting the --insecure flag
  • New flag: Add --no-healthcheck flag to disable periodic health checks
  • Tests: Add HTTPS healthcheck tests for certificate validation scenarios
  • Documentation: Update README.md and REFERENCE.md

Test plan

  • Unit tests pass (go test ./pkg/...)
  • Build succeeds
  • New --no-healthcheck flag appears in hookdeck listen --help
  • Manual test with HTTPS endpoint and self-signed certificate

Fixes #198

Made with Cursor

The healthcheck functionality was using raw TCP connections which caused
TLS handshake warnings on HTTPS servers with self-signed certificates.

Changes:
- Use tls.DialWithDialer for HTTPS endpoints with InsecureSkipVerify
  respecting the --insecure flag
- Add --no-healthcheck flag to disable health monitoring entirely
- Update tests for HTTPS healthcheck scenarios
- Update documentation for both flags

Fixes #198

Co-authored-by: Cursor <cursoragent@cursor.com>
@leggetter
Copy link
Collaborator Author

@copilot can you review?

Copy link
Contributor

Copilot AI commented Feb 3, 2026

@leggetter I've opened a new pull request, #200, to work on those changes. Once the pull request is ready, I'll request review from you.

@leggetter leggetter merged commit 4a5368c into main Feb 3, 2026
6 checks passed
@leggetter leggetter deleted the fix/healthcheck-https branch February 3, 2026 18:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

TLS handshake warnings on local webserver triggered by Hookdeck CLI

2 participants