diff --git a/.ci/docs.sh b/.ci/docs.sh
index 1b9b5675..625c6018 100755
--- a/.ci/docs.sh
+++ b/.ci/docs.sh
@@ -32,6 +32,7 @@ if [ "$fail" -eq 1 ]; then
 fi
 
 sphinx-build \
+	--fail-on-warning \
 	docs \
 	public \
 
diff --git a/.gitlab-ci.yml b/.gitlab-ci.yml
index 8114a816..a629b0d4 100644
--- a/.gitlab-ci.yml
+++ b/.gitlab-ci.yml
@@ -90,6 +90,9 @@ mypy:
 
 docs:
   stage: test
+  # py3-sphinx >= 7.3 is needed for --fail-on-warning
+  # alpine:3.20 is on py3-sphinx 7.2.x
+  image: alpine:edge
   script:
     - ".ci/docs.sh"
   artifacts: