1
0
mirror of https://blitiri.com.ar/repos/chasquid synced 2025-12-18 14:47:03 +00:00
Files
go-chasquid-smtp/docs/haproxy.md
Alberto Bertogli 4f595ce3d2 docs: Document that only haproxy v1 is supported
Document that only haproxy's PROXY protocol v1 is supported. This can
help users configure their instance and avoid trying to set up other
versions.

Thanks to Björn Busse (bbuse@github) for reporting this!
2021-12-06 17:56:07 +00:00

35 lines
799 B
Markdown

# HAProxy integration
As of version 1.6, [chasquid] supports being deployed behind a [HAProxy]
instance.
**This is EXPERIMENTAL for now, and can change in backwards-incompatible
ways.**
## Configuring HAProxy
In the backend server line, set the [send-proxy] parameter to turn on the use
of the PROXY protocol against chasquid.
You need to set this for each of the ports that are forwarded.
Only PROXY protocol v1 is supported for now.
## Configuring chasquid
Add the following line to `/etc/chasquid/chasquid.conf`:
```
haproxy_incoming: true
```
That turns HAProxy support on for all incoming SMTP connections.
[chasquid]: https://blitiri.com.ar/p/chasquid
[HAProxy]: https://www.haproxy.org/
[send-proxy]: http://cbonte.github.io/haproxy-dconv/2.0/configuration.html#5.2-send-proxy