From 5d802989aa8666ae199a25e55b7d5edf9f8e5bf4 Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?C=C3=A9dric=20Krier?= <ced@b2ck.com>
Date: Sat, 20 Nov 2021 00:11:56 +0100
Subject: [PATCH] Add warning and note about starting server for production

issue10934
review351001002
---
 doc/topics/start_server.rst | 10 ++++++++++
 1 file changed, 10 insertions(+)

diff --git a/doc/topics/start_server.rst b/doc/topics/start_server.rst
index b692d0c454..d3c791af7d 100644
--- a/doc/topics/start_server.rst
+++ b/doc/topics/start_server.rst
@@ -17,6 +17,12 @@ The server will wait for client connections on the interface defined in the
 .. note:: When using multiple config files the order is importart as last
           entered files will override the items of first files
 
+.. warning::
+   This runs the of `Werkzeug`_ development server which should not be used on
+   production systems.
+
+.. _`Werkzeug`: https://werkzeug.palletsprojects.com/
+
 WSGI server
 -----------
 
@@ -45,6 +51,10 @@ long-polling request on the :ref:`bus <ref-bus>` as each client consumes
 permanently one thread.
 You can start the server with coroutine using the option ``--coroutine``.
 
+.. note::
+   This will use the pure-Python, gevent-friendly `WSGI server
+   <http://www.gevent.org/api/gevent.pywsgi.html>`_.
+
 Cron service
 ============