--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/doc/book/admin/deploy.rst	Fri Jan 31 17:07:25 2020 +0100
@@ -0,0 +1,68 @@
+.. -*- coding: utf-8 -*-
+
+Deploy a *CubicWeb* application
+===============================
+
+Deployment with uwsgi
+---------------------
+
+`uWSGI <https://uwsgi-docs.readthedocs.io/>`_ is often used to deploy CubicWeb
+applications.
+
+Short version is install `uwsgi`:
+
+.. sourcecode:: console
+
+  apt install uwsgi
+
+Deploy a configuration file for your application
+`/etc/uwsgi/apps-enabled/example.ini`:
+
+.. sourcecode:: ini
+
+    [uwsgi]
+    master = true
+    http = 0.0.0.0:8080
+    env = CW_INSTANCE=example
+    wsgi-file = /etc/cubicweb.d/example/wsgiapp.py
+    processes = 8
+    threads = 1
+    plugins = http,python3
+    auto-procname = true
+    lazy-apps = true
+    log-master = true
+    # disable uwsgi request logging
+    disable-logging = true
+    stats = 127.0.0.1:1717
+
+The `wsgiapp.py` file looks like this:
+
+.. sourcecode:: python
+
+    import os
+    from cubicweb.pyramid import wsgi_application_from_cwconfig
+    from cubicweb.cwconfig import CubicWebConfiguration as cwcfg
+
+    appid = os.environ['CW_INSTANCE']  # instance name
+    cwconfig = cwcfg.config_for(appid)
+
+    cwconfig.log_format = ('{0} pid:{1} (%(name)s) %(levelname)s: %(message)s'
+                           .format(appid, os.getpid()))
+
+    application = wsgi_application_from_cwconfig(cwconfig)
+    repo = application.application.registry['cubicweb.repository']
+
+
+Deployment with SaltStack
+-------------------------
+
+To deploy with SaltStack one can refer themselves to the
+`cubicweb-formula <https://hg.logilab.org/master/salt/cubicweb-formula/>`_.
+
+Deployment with Kubernetes
+--------------------------
+
+To deploy in a Kubernetes cluster, you can take inspiration from the
+instructions included in
+`the fresh cube  <https://hg.logilab.org/master/cubes/fresh/file/tip/README.rst#l20>`_
+and the `deployment yaml files <https://hg.logilab.org/master/cubes/fresh/file/tip/deploy>`_.

--- a/doc/book/admin/index.rst	Fri Jan 31 16:52:24 2020 +0100
+++ b/doc/book/admin/index.rst	Fri Jan 31 17:07:25 2020 +0100
@@ -14,6 +14,7 @@
    :numbered:
 
    setup
+   deploy
    config
    cubicweb-ctl
    create-instance