config¶

Configuration options for HAProxy backend services

HAProxy Frontend Configuration¶

This parameter defines configuration options for HAProxy frontend sections, allowing per-service customization of connection handling, modes, and other frontend-specific settings.

For full documentation of all available directives, refer to the HAProxy Configuration Manual: https://www.haproxy.com/documentation/haproxy-configuration-manual/latest/#4.1

Requirements¶

Must use valid HAProxy frontend configuration syntax
mode must be appropriate for the service (tcp/http/log)
Custom configurations must follow HAProxy syntax rules

Usage¶

Configure frontend settings with either mode specification or custom configuration:

haproxy/frontend/config:
  http:
    mode: http
  https:
    mode: tcp
  custom_service:
    config: |
      mode tcp
      bind 127.0.0.1:8099
      option tcplog

The configuration supports: - mode: Connection mode (tcp/http/log) - config: Custom configuration block for advanced settings

Example with multiple services:

haproxy/frontend/config:
  http:
    mode: http
    config: |
      option forwardfor
      http-request add-header X-Forwarded-Proto https
  https:
    mode: tcp
    config: |
      option tcplog
      bind *:443 ssl crt /etc/ssl/certs/cert.pem