From 4ba5d1ac21c645b54ce95084606027c55e589a15 Mon Sep 17 00:00:00 2001
From: Tristan <tristan@mangadex.org>
Date: Mon, 6 Jun 2022 10:49:04 +0100
Subject: [PATCH] Update README with example setup for H3/QUIC

---
 README.md | 28 +++++++++++++++++++++++++---
 1 file changed, 25 insertions(+), 3 deletions(-)

diff --git a/README.md b/README.md
index da5b29d..f429819 100644
--- a/README.md
+++ b/README.md
@@ -6,9 +6,31 @@ Build scripts for HAProxy with QUIC
 
 ## Quickstart
 
-    docker run -it \
-        -v /path/to/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro \
-        registry.gitlab.com/mangadex-pub/haproxy:2.6-bullseye
+**NOTE FOR QUIC:** docker and docker-compose require explicit UDP protocol port mapping, otherwise they assume only-TCP. See below.
+
+```shell
+docker run -it \
+    -v /path/to/haproxy.cfg:/usr/local/etc/haproxy/haproxy.cfg:ro \
+    -p "80:80" \
+    -p "443:443/tcp" \
+    -p "443:443/udp" \
+    registry.gitlab.com/mangadex-pub/haproxy:2.6-bullseye
+```
+
+Here's a sample configuration (requires you to figure out the certificate) to test HTTP/3.0 support. The first connection should be over HTTP/1.1 or HTTP/2, and
+after a few refreshes it should be over HTTP/3.
+
+See [Announcing HAProxy 2.6](https://www.haproxy.com/blog/announcing-haproxy-2-6/) for more info.
+
+```haproxy
+...
+frontend https
+    bind       :443 ssl crt /usr/local/etc/haproxy/cert.pem alpn h2,http/1.1
+    bind quic4@:443 ssl crt /usr/local/etc/haproxy/cert.pem alpn h3
+    
+    http-after-response set-header alt-svc 'h3=":443"; ma=86400'
+    http-request return status 200 content-type text/plain lf-string "Connected via %HV"
+```
 
 ## Build it