ray.serve.schema.HTTPOptionsSchema#

pydantic model ray.serve.schema.HTTPOptionsSchema[source]#

Options to start the HTTP Proxy with.

NOTE: This config allows extra parameters to make it forward-compatible (ie

older versions of Serve are able to accept configs from a newer versions, simply ignoring new parameters).

field host: str = '0.0.0.0'#

Host for HTTP servers to listen on. Defaults to all interfaces (0.0.0.0 for IPv4, :: for IPv6), which exposes Serve publicly. Cannot be updated once Serve has started running. Serve must be shut down and restarted with the new host instead.

field keep_alive_timeout_s: int = 90#

The HTTP proxy will keep idle connections alive for this duration before closing them when no requests are ongoing. Defaults to 90 seconds.

field port: int = 8000#

Port for HTTP server. Defaults to 8000. Cannot be updated once Serve has started running. Serve must be shut down and restarted with the new port instead.

field request_timeout_s: float | None = None#

The timeout for HTTP requests. Defaults to no timeout.

field root_path: str = ''#

Root path to mount the serve application (for example, “/serve”). All deployment routes will be prefixed with this path. Defaults to “”.

field ssl_ca_certs: str | None = None#

Path to the CA certificate file for verifying client certificates.

field ssl_certfile: str | None = None#

Path to the SSL certificate file for HTTPS. If provided with ssl_keyfile, the HTTP server will use HTTPS. Cannot be updated once Serve has started.

field ssl_keyfile: str | None = None#

Path to the SSL key file for HTTPS. If provided with ssl_certfile, the HTTP server will use HTTPS. Cannot be updated once Serve has started.

field ssl_keyfile_password: str | None = None#

Password for the SSL key file, if encrypted.

validator validate_ssl_certfile  »  ssl_certfile[source]#