From a64834b4443fb39666cfba190c72d7beeaf59a88 Mon Sep 17 00:00:00 2001
From: Akhil Narang <me@akhilnarang.dev>
Date: Tue, 6 Jan 2026 01:33:09 +0530
Subject: [PATCH] fix(connections): try all available interfaces, not just ipv4

Signed-off-by: Akhil Narang <me@akhilnarang.dev>
---
 frappe/utils/connections.py | 73 ++++++++++++++++++++++++++++++-------
 1 file changed, 60 insertions(+), 13 deletions(-)

diff --git a/frappe/utils/connections.py b/frappe/utils/connections.py
index e51cbbd829..b914e9061c 100644
--- a/frappe/utils/connections.py
+++ b/frappe/utils/connections.py
@@ -10,25 +10,72 @@ from frappe.exceptions import UrlSchemeNotSupported
 REDIS_KEYS = ("redis_cache", "redis_queue")
 
 
-def is_open(scheme, hostname, port, path, timeout=10):
-	if scheme in ["redis", "rediss", "postgres", "mariadb"]:
-		s = socket.socket(socket.AF_INET, socket.SOCK_STREAM)
-		conn = (hostname, int(port))
-	elif scheme == "unix":
-		s = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
-		conn = path
-	else:
-		raise UrlSchemeNotSupported(scheme)
+def can_connect(sock: socket.socket, address: tuple[str, int] | str, timeout: int | float) -> bool:
+	"""
+	Check whether we can connect to a socket address.
 
-	s.settimeout(timeout)
+	Args:
+		sock: The socket object to use for the connection.
+		address: The address to connect to (tuple for network, string for unix).
+		timeout: Connection timeout in seconds.
+
+	Returns:
+		True if connection was successful, False otherwise.
+	"""
+	sock.settimeout(timeout)
 	try:
-		s.connect(conn)
-		s.shutdown(socket.SHUT_RDWR)
+		sock.connect(address)
+		sock.shutdown(socket.SHUT_RDWR)
 		return True
 	except OSError:
 		return False
 	finally:
-		s.close()
+		sock.close()
+
+
+def is_open(
+	scheme: str,
+	hostname: str | None,
+	port: int | str | None,
+	path: str | None,
+	timeout: int | float = 10,
+) -> bool:
+	"""
+	Check if a service is reachable via socket connection.
+
+	Args:
+		scheme: The URL scheme (redis, mariadb, etc.) or 'unix'.
+		hostname: The remote host to connect to.
+		port: The port number to connect to.
+		path: The path to the unix socket (if scheme is 'unix').
+		timeout: Connection timeout in seconds.
+
+	Returns:
+		True if the service is reachable, False otherwise.
+	"""
+	if scheme in ("redis", "rediss", "postgres", "mariadb"):
+		if not hostname or not port:
+			return False
+
+		try:
+			addresses = socket.getaddrinfo(hostname, port, socket.AF_UNSPEC, socket.SOCK_STREAM)
+		except (socket.gaierror, TypeError):
+			return False
+
+		# Try all addresses returned by getaddrinfo
+		for family, socket_type, proto, _, address in addresses:
+			s = socket.socket(family, socket_type, proto)
+			if can_connect(s, address, timeout):
+				return True
+		return False
+
+	if scheme == "unix":
+		if not path:
+			return False
+		s = socket.socket(socket.AF_UNIX, socket.SOCK_STREAM)
+		return can_connect(s, path, timeout)
+
+	raise UrlSchemeNotSupported(scheme)
 
 
 def check_database():