diff --git a/akka-docs/rst/java/code/docs/io/JavaUdpMulticastTest.java b/akka-docs/rst/java/code/docs/io/JavaUdpMulticastTest.java
index e5fc939ae2..666735f4c9 100644
--- a/akka-docs/rst/java/code/docs/io/JavaUdpMulticastTest.java
+++ b/akka-docs/rst/java/code/docs/io/JavaUdpMulticastTest.java
@@ -34,10 +34,13 @@ public class JavaUdpMulticastTest {
             NetworkInterface ipv6Iface = null;
             for (Enumeration<NetworkInterface> interfaces = NetworkInterface.getNetworkInterfaces(); interfaces.hasMoreElements() && ipv6Iface == null;) {
                 NetworkInterface interf = interfaces.nextElement();
-                for (Enumeration<InetAddress> addresses = interf.getInetAddresses(); addresses.hasMoreElements() && ipv6Iface == null;) {
-                    InetAddress address = addresses.nextElement();
-                    if (address instanceof Inet6Address) {
-                        ipv6Iface = interf;
+                // awdl0 is a special interface on OSX that we cannot use
+                if (!interf.getDisplayName().equals("awdl0")) {
+                    for (Enumeration<InetAddress> addresses = interf.getInetAddresses(); addresses.hasMoreElements() && ipv6Iface == null; ) {
+                        InetAddress address = addresses.nextElement();
+                        if (address instanceof Inet6Address) {
+                            ipv6Iface = interf;
+                        }
                     }
                 }
             }
diff --git a/akka-docs/rst/scala/code/docs/io/ScalaUdpMulticastSpec.scala b/akka-docs/rst/scala/code/docs/io/ScalaUdpMulticastSpec.scala
index a4ba2dff71..d7ab59121c 100644
--- a/akka-docs/rst/scala/code/docs/io/ScalaUdpMulticastSpec.scala
+++ b/akka-docs/rst/scala/code/docs/io/ScalaUdpMulticastSpec.scala
@@ -20,7 +20,8 @@ class ScalaUdpMulticastSpec extends TestKit(ActorSystem("ScalaUdpMulticastSpec")
   "listener" should {
     "send message back to sink" in {
       val Some(ipv6Iface) = NetworkInterface.getNetworkInterfaces.collectFirst {
-        case iface if iface.getInetAddresses.exists(_.isInstanceOf[Inet6Address]) => iface
+        // awdl0 is a special interface on OSX that we cannot use
+        case iface if iface.getInetAddresses.exists(_.isInstanceOf[Inet6Address]) && iface.getDisplayName != "awdl0" => iface
       }
 
       // host assigned link local multicast address http://tools.ietf.org/html/rfc3307#section-4.3.2