From 74177d9ba3fe9feeeb546af3cc766291918dba0c Mon Sep 17 00:00:00 2001
From: Slavi Pantaleev <slavi@devture.com>
Date: Fri, 21 Feb 2025 16:37:41 +0200
Subject: [PATCH] Document the state of the `ip6tables` and `experimental`
 daemon options for Docker

---
 group_vars/matrix_servers | 8 ++++++++
 1 file changed, 8 insertions(+)

diff --git a/group_vars/matrix_servers b/group_vars/matrix_servers
index 94e0f3fc9..832fe5df7 100755
--- a/group_vars/matrix_servers
+++ b/group_vars/matrix_servers
@@ -22,6 +22,14 @@ matrix_playbook_docker_installation_enabled: true
 matrix_playbook_docker_installation_daemon_options: "{{ matrix_playbook_docker_installation_daemon_options_auto | combine(matrix_playbook_docker_installation_daemon_options_custom, recursive=True) }}"
 
 matrix_playbook_docker_installation_daemon_options_auto:
+  # Since Docker 27.0.1:
+  # - `experimental` is no longer required to enable `ip6tables`
+  # - `ip6tables` defaults to enabled
+  #
+  # See: https://docs.docker.com/engine/release-notes/27/#ipv6
+  #
+  # Still, we intend to keep these around a while longer to benefit people who are still on older versions.
+  # In the future, we won't be specifying any of these options by default.
   experimental: "{{ devture_systemd_docker_base_ipv6_enabled }}"
   ip6tables: "{{ devture_systemd_docker_base_ipv6_enabled }}"