Networking & Integration

How connections flow through Ghostunnel, how the process integrates with its environment, and how to observe it in production.

PROXY Protocol

Pass original client connection metadata (IP, TLS version, client certificate) through to plaintext backends using HAProxy's PROXY protocol v2.

Socket Activation

Use systemd (Linux) or launchd (macOS) socket activation for on-demand startup.

Graceful Shutdown

How Ghostunnel handles shutdown signals, drains in-flight connections, and force-exits after a timeout.

Metrics & Profiling

Expose status, health checks, and metrics in JSON or Prometheus format via the built-in status port.