summaryrefslogtreecommitdiff
path: root/docs/narr/project.rst
diff options
context:
space:
mode:
authorSteve Piercy <web@stevepiercy.com>2016-12-06 04:24:04 -0800
committerGitHub <noreply@github.com>2016-12-06 04:24:04 -0800
commit7ab666e3e2539662ff3324a4bdedbca3c8f8040a (patch)
treeb34855b833113681b8ce7ba1001d1a2a8a089775 /docs/narr/project.rst
parentfedfacf0bd1cbefbe922618d4df93917465f1307 (diff)
parent0705eeaa820b32a4c3f2a05df21e99077586cf5e (diff)
downloadpyramid-7ab666e3e2539662ff3324a4bdedbca3c8f8040a.tar.gz
pyramid-7ab666e3e2539662ff3324a4bdedbca3c8f8040a.tar.bz2
pyramid-7ab666e3e2539662ff3324a4bdedbca3c8f8040a.zip
Merge pull request #2847 from mfrlin/issue-2656
Changed 'host' and 'port' configuration to a new 'listen' style that …
Diffstat (limited to 'docs/narr/project.rst')
-rw-r--r--docs/narr/project.rst11
1 files changed, 5 insertions, 6 deletions
diff --git a/docs/narr/project.rst b/docs/narr/project.rst
index 6c42881f4..ec26b880e 100644
--- a/docs/narr/project.rst
+++ b/docs/narr/project.rst
@@ -295,16 +295,15 @@ Here's sample output from a run of ``pserve`` on UNIX:
Access is restricted such that only a browser running on the same machine as
Pyramid will be able to access your Pyramid application. However, if you want
to open access to other machines on the same network, then edit the
-``development.ini`` file, and replace the ``host`` value in the
-``[server:main]`` section, changing it from ``127.0.0.1`` to ``0.0.0.0``. For
+``development.ini`` file, and replace the ``listen`` value in the
+``[server:main]`` section, changing it from ``127.0.0.1:6543`` to ``0.0.0.0:6543``. For
example:
.. code-block:: ini
[server:main]
use = egg:waitress#main
- host = 0.0.0.0
- port = 6543
+ listen = 0.0.0.0:6543
Now when you use ``pserve`` to start the application, it will respond to
requests on *all* IP addresses possessed by your system, not just requests to
@@ -320,8 +319,8 @@ browser by visiting ``http://192.168.1.50:6543/``.
You can change the port on which the server runs on by changing the same
portion of the ``development.ini`` file. For example, you can change the
-``port = 6543`` line in the ``development.ini`` file's ``[server:main]``
-section to ``port = 8080`` to run the server on port 8080 instead of port 6543.
+``listen = 127.0.0.1:6543`` line in the ``development.ini`` file's ``[server:main]``
+section to ``listen = 127:0.0.1:8080`` to run the server on port 8080 instead of port 6543.
You can shut down a server started this way by pressing ``Ctrl-C`` (or
``Ctrl-Break`` on Windows).