]> git.ipfire.org Git - thirdparty/Python/cpython.git/commitdiff
Add a security warning about `pydoc`'s HTTP server (#150409)
authorStan Ulbrych <stan@python.org>
Fri, 29 May 2026 12:29:59 +0000 (13:29 +0100)
committerGitHub <noreply@github.com>
Fri, 29 May 2026 12:29:59 +0000 (13:29 +0100)
Doc/library/pydoc.rst

index f236eba84576575348a3a38b6678be02c8dad85d..a0cfb440a36ffa9b2fd0f4118f1472025232272b 100644 (file)
@@ -68,6 +68,11 @@ will start a HTTP server on port 1234, allowing you to browse the
 documentation at ``http://localhost:1234/`` in your preferred web browser.
 Specifying ``0`` as the port number will select an arbitrary unused port.
 
+.. warning::
+
+   The :mod:`!pydoc` HTTP server is intended for local use during
+   development and is not suitable for production use.
+
 :program:`python -m pydoc -n <hostname>` will start the server listening at the given
 hostname.  By default the hostname is 'localhost' but if you want the server to
 be reached from other machines, you may want to change the host name that the