User guide¶

Deploy an application¶

• Behind a reverse proxy — nginx, Caddy, and HAProxy recipes, forwarded identity, and WebSocket routing.
• Direct TLS — certificates, client authentication, and HTTPS without a separate proxy.
• Migrating to h2corn — commands and behavior changes from Uvicorn, Hypercorn, and Gunicorn.

Run and monitor¶

• Operations — worker pools, configuration, readiness, rolling reload, shutdown, and logs.
• Troubleshooting — connection errors, startup failures, proxy identity, TLS, and reload.
• Configuration reference — CLI flags, environment variables, TOML settings, and defaults.

Integrate with Python¶

• Embedding — run a server in your event loop, await readiness, and control shutdown.
• WebSockets — application code and HTTP/1.1 or HTTP/2 transport requirements.
• ASGI support — file sending, lifespan state, extensions, and errors from send().
• gRPC and Connect — host generated RPC applications and configure native gRPC admission.
• Python API — Config, Server, serve, and typed ASGI messages.