Add note about EADDRINUSE to docs

1 files changed, 17 insertions, 0 deletions

diff --git a/doc/api/net.markdown b/doc/api/net.markdown
index 62947d627a3..7b69a2986d8 100644
--- a/doc/api/net.markdown
+++ b/doc/api/net.markdown
@@ -66,6 +66,23 @@ IPv4 address (`INADDR_ANY`).
 This function is asynchronous. The last parameter `callback` will be called
 when the server has been bound.
 
+One issue some users run into is getting `EADDRINUSE` errors. Meaning
+another server is already running on the requested port. One way of handling this
+would be to wait a second and the try again. This can be done with
+
+    server.on('error', function (e) {
+      if (e.errno == require('constants').EADDRINUSE) {
+        console.log('Address in use, retrying...');
+        setTimeout(function () {
+          server.close();
+          server.listen(PORT, HOST);
+        }, 1000);
+      }
+    });
+
+(Note: All sockets in Node are set SO_REUSEADDR already)
+
+
 #### server.listen(path, [callback])
 
 Start a UNIX socket server listening for connections on the given `path`.