From db48dd355d92d50510791c08ee8930091fdc85f5 Mon Sep 17 00:00:00 2001
From: benoitc <bchesneau@gmail.com>
Date: Tue, 23 Apr 2013 16:51:24 +0200
Subject: [PATCH] add systemd documentation

---
 docs/source/deploy.rst | 40 ++++++++++++++++++++++++++++++++++++++++
 docs/source/news.rst   |  1 +
 2 files changed, 41 insertions(+)

diff --git a/docs/source/deploy.rst b/docs/source/deploy.rst
index 83f1c6c7..d7f80f71 100644
--- a/docs/source/deploy.rst
+++ b/docs/source/deploy.rst
@@ -201,6 +201,45 @@ Another useful tool to monitor and control Gunicorn is Supervisor_. A
     autorestart=true
     redirect_stderr=True
 
+Systemd
+-------
+
+A tool that is starting to be common on linux systems is Systemd_. Here
+are configurations files to set the gunicorn launch in systemd and 
+the interfaces on which gunicorn will listen. The sockets will be managed by
+systemd:
+
+**gunicorn.service**::
+
+    [Unit]
+    Description=gunicorn daemon
+
+    [Service]
+    User=urban
+    WorkingDirectory=/home/urban/gunicorn/bin
+    ExecStart=/home/urban/gunicorn/bin/gunicorn --debug --log-level debug test:app
+
+    [Install]
+    WantedBy=multi-user.target
+
+**gunicorn.socket**::
+
+    [Unit]
+    Description=gunicorn socket
+
+    [Socket]
+    ListenStream=/run/unicorn.sock
+    ListenStream=0.0.0.0:9000
+    ListenStream=[::]:8000
+
+    [Install]
+    WantedBy=sockets.target
+
+After running curl http://localhost:9000/ gunicorn should start and you
+should see something like that in logs::
+
+    2013-02-19 23:48:19 [31436] [DEBUG] Socket activation sockets: unix:/run/unicorn.sock,http://0.0.0.0:9000,http://[::]:8000
+
 Logging
 =======
 
@@ -221,3 +260,4 @@ utility::
 .. _`configuration documentation`: http://gunicorn.org/configure.html#logging
 .. _`logging configuration file`: https://github.com/benoitc/gunicorn/blob/master/examples/logging.conf
 .. _Virtualenv: http://pypi.python.org/pypi/virtualenv
+.. _Systemd: http://www.freedesktop.org/wiki/Software/systemd
diff --git a/docs/source/news.rst b/docs/source/news.rst
index c86d358d..ee743a56 100644
--- a/docs/source/news.rst
+++ b/docs/source/news.rst
@@ -4,6 +4,7 @@ Changelog
 0.17.3 / 2013-04-23
 -------------------
 
+- add systemd sockets support 
 - add ``python -m gunicorn.app.wsgiapp`` support 
 - improve logger class inheritance
 - exit when the config file isn't found