diff options
| -rw-r--r-- | guide/listeners.md | 17 | ||||
| -rw-r--r-- | guide/toc.md | 2 |
2 files changed, 13 insertions, 6 deletions
diff --git a/guide/listeners.md b/guide/listeners.md index 59aa990..1f7c430 100644 --- a/guide/listeners.md +++ b/guide/listeners.md @@ -99,12 +99,19 @@ argument is the name of the listener you gave in `ranch:start_listener/6`. Port = ranch:get_port(tcp_echo). ``` -Listening on a port =< 1024 ---------------------------- +Listening on privileged ports +----------------------------- -This is currently not possible. We recommend the use of load balancing -or NAT firewall rules if the need arise. Proxies can sometimes also be -used although that's a less efficient solution. +Some systems limit access to ports below 1024 for security reasons. +This can easily be identified by an `{error, eacces}` error when trying +to open a listening socket on such a port. + +The methods for listening on privileged ports vary between systems, +please refer to your system's documentation for more information. + +We recommend the use of port rewriting for systems with a single server, +and load balancing for systems with multiple servers. Documenting these +solutions is however out of the scope of this guide. Limiting the number of concurrent connections --------------------------------------------- diff --git a/guide/toc.md b/guide/toc.md index 104dd3d..f83b6c6 100644 --- a/guide/toc.md +++ b/guide/toc.md @@ -8,7 +8,7 @@ Ranch User Guide * Purpose * Starting and stopping * Listening on a random port - * Listening on a port =< 1024 + * Listening on privileged ports * Limiting the number of concurrent connections * Upgrading * [Transports](transports.md) |