From dc3c0f00f31d3ab6bd58c68b6fd87edac3263b51 Mon Sep 17 00:00:00 2001
From: tmancill <1195611+tmancill@users.noreply.github.com>
Date: Sat, 9 Sep 2023 09:26:04 -0700
Subject: [PATCH] misc readme updates (#2235)

* Update README.md regarding the archived freeswitch-users mailing list

* update docker/README.md to suggest --network host
---
 README.md        |  4 ++--
 docker/README.md | 18 ++++++++++--------
 2 files changed, 12 insertions(+), 10 deletions(-)

diff --git a/README.md b/README.md
index 15cda2e22f..728486f891 100644
--- a/README.md
+++ b/README.md
@@ -67,8 +67,8 @@ This is the place to get answers faster and chat with other users in real time.
 Slack Community:
   * https://signalwire.community/
 
-Mailing list:
+Mailing list (ARCHIVED):
 
-  * http://lists.freeswitch.org/mailman/listinfo/freeswitch-users
+  * http://lists.freeswitch.org/pipermail/freeswitch-users/
 
 **Thank you for using FreeSWITCH!**
diff --git a/docker/README.md b/docker/README.md
index e9a321e699..e0ebfff2af 100644
--- a/docker/README.md
+++ b/docker/README.md
@@ -2,7 +2,7 @@
 These are the official Docker files for master branch and the current release packages.
 
 ## Volumes
-These containers are setup so that you can mount your freeswitch configuration form a host or data volume container.
+These containers are set up so that you can mount your freeswitch configuration from a host or data volume container.
 
 To mount freeswitch Configuration
 ```
@@ -16,17 +16,19 @@ To mount tmp directory for storing recordings, etc
 
 The container also has a healthcheck where it does a fs_cli status check to make sure the freeswitch service is still running.
 
-# Ports
+## Ports
 
-The container exposes the following ports:
+The container should be run with host networking using `docker run --network host ...`.
 
-- 5060/tcp 5060/udp 5080/tcp 5080/udp as SIP Signaling ports.
-- 5066/tcp 7443/tcp as WebSocket Signaling ports.
-- 8021/tcp as Event Socket port.
-- 64535-65535/udp as media ports.
-- 16384-32768/udp
+If you prefer to (or for some reason must) publish individual ports via `--publish/-p`, refer to this [issue](https://github.com/moby/moby/issues/11185) and this [potential workaround](https://hub.docker.com/r/bettervoice/freeswitch-container/) regarding using docker with large port ranges.
 
+The following ports will be used, depending upon your specific configuration:
 
+- 5060/tcp, 5060/udp, 5080/tcp, 5080/udp - SIP signaling
+- 5061/tcp, 5081/tcp - SIPS signaling
+- 5066/tcp, 7443/tcp - WebSocket signaling
+- 8021/tcp - the Event Socket
+- 16384-32768/udp,  64535-65535/udp - media
 
 
 If you wish to help improve these please submit a pull request at: