HTTP server properties

HTTP server properties allow you to configure the HTTP server of Trino that handles including , and serves the and the client API.

General

(http-server-process-forwarded)=

http-server.process-forwarded

• Type:
• Default value: false

Enable treating forwarded HTTPS requests over HTTP as secure. Requires the X-Forwarded headers to be set to HTTPS on forwarded requests. This is commonly performed by a load balancer that terminates HTTPS to HTTP. Set to true when using such a load balancer in front of Trino or Trino Gateway. Find more details in .

HTTP and HTTPS

http-server.http.port

• Type:
• Default value: 8080

Specify the HTTP port for the HTTP server.

http-server.https.enabled

• Type:
• Default value: false

Enable .

http-server.https.port

• Type:
• Default value: 8443

Specify the HTTPS port for the HTTP server.

http-server.https.included-cipher and http-server.https.excluded-cipher

Optional configuration for ciphers to use TLS, find details in .

http-server.https.keystore.path

• Type:

The location of the PEM or Java keystore file used to enable .

http-server.https.keystore.key

• Type:

The password for the PEM or Java keystore.

http-server.https.truststore.path

• Type:
• Default value: false

The location of the optional PEM or Java truststore file for additional certificate authorities. Find details in .

http-server.https.truststore.key

• Type:
• Default value: false

The password for the optional PEM or Java truststore.

http-server.https.keymanager.password

• Type:

Password for a key within a keystore, when a different password is configured for the specific key. Find details in .

http-server.https.secure-random-algorithm

• Type:

Optional name of the algorithm to generate secure random values for internal communication.

http-server.https.ssl-session-timeout

• Type:
• Default value: 4h

Time duration for a valid TLS client session.

http-server.https.ssl-session-cache-size

• Type:
• Default value: 10000

Maximum number of SSL session cache entries.

http-server.https.ssl-context.refresh-time

• Type:
• Default value: 1m

Time between reloading default certificates.

Authentication

http-server.authentication.type

• Type:

Configures the ordered list of enabled authentication types.

All authentication requires secure connections using or process forwarding enabled, and a configured shared secret.

http-server.authentication.allow-insecure-over-http

• Type:

Enable HTTP when any authentication is active. Defaults to true, but is automatically set to false with active authentication. Overriding the value to true can be useful for testing, but is not secure. More details in .

http-server.authentication.certificate.*

Configuration properties for .

http-server.authentication.jwt.*

Configuration properties for .

http-server.authentication.krb5.*

Configuration properties for .

http-server.authentication.oauth2.*

Configuration properties for .

http-server.authentication.password.*

Configuration properties for the PASSWORD authentication types , , and .

Logging

http-server.log.*

Configuration properties for .

(props-internal-communication)

Internal communication

The following properties are used for configuring the internal communication between all nodes of a Trino cluster.

internal-communication.shared-secret

• Type:

The string to use as secret that only the coordinators and workers in a specific cluster share and use to authenticate within the cluster. See for details.

internal-communication.http2.enabled

• Type:
• Default value: true

Enable use of the HTTP/2 protocol for internal communication for enhanced scalability compared to HTTP/1.1. Only turn this feature off if you encounter issues with HTTP/2 usage within the cluster in your deployment.

internal-communication.https.required

• Type:
• Default value: false

Enable the use of SSL/TLS for all internal communication.