WildFly Full 25 Model Reference

  1. home
  2. subsystem=undertow
  3. configuration=handler
  4. reverse-proxy
  5. host

A host that the reverse proxy will forward requests to

Provided capabilities(1)

Name Dynamic Other provider points
org.wildfly.undertow.reverse-proxy.host true

none

Attributes (7)

  • enable-http2 If this is true then the proxy will attempt to use HTTP/2 to connect to the backend. If it is not supported it will fall back to HTTP/1.1.
    • Attribute Value
    Default Value false
    Type BOOLEAN
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • instance-id The instance id (aka JVM route) that will be used to enable sticky sessions
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • outbound-socket-binding Outbound socket binding for this host
    • Attribute Value
    Capability reference
    Type STRING
    Nillable false
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • path Optional path if host is using non root resource
    • Attribute Value
    Default Value /
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • scheme What kind of scheme is used
    • Attribute Value
    Default Value http
    Type STRING
    Nillable true
    Expressions Allowed true
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • security-realm The security realm that provides the SSL configuration for the connection to the host
    • Attribute Value
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services
  • ssl-context Reference to the SSLContext to be used by this handler.
    • Attribute Value
    Capability reference
    Type STRING
    Nillable true
    Expressions Allowed false
    Storage configuration
    Access Type read-write
    Restart Required all-services

Operations (2)

  • add Adds a reverse proxy handler host
    Request Parameter Type Required Expressions Allowed Default value Description
    enable-http2 BOOLEAN false false false If this is true then the proxy will attempt to use HTTP/2 to connect to the backend. If it is not supported it will fall back to HTTP/1.1.
    instance-id STRING false true The instance id (aka JVM route) that will be used to enable sticky sessions
    outbound-socket-binding STRING true true Outbound socket binding for this host
    path STRING false true / Optional path if host is using non root resource
    scheme STRING false true http What kind of scheme is used
    security-realm STRING false false The security realm that provides the SSL configuration for the connection to the host
    ssl-context STRING false false Reference to the SSLContext to be used by this handler.
  • remove Removes a reverse proxy handler host