summary refs log tree commit diff
path: root/doc
diff options
context:
space:
mode:
authorDavid Thompson <dthompson2@worcester.edu>2015-08-02 23:29:53 -0400
committerDavid Thompson <dthompson2@worcester.edu>2015-08-27 22:10:40 -0400
commit58724c488b17cf2babfadebf790396426f3a801f (patch)
tree02fde5a164edb88f01b174fe87a46f550ae83d1a /doc
parent3aae8145a73fc7116694c3d8bfced11ae332b491 (diff)
downloadguix-58724c488b17cf2babfadebf790396426f3a801f.tar.gz
gnu: services: Add nginx-service.
* gnu/services/web.scm: New file.
* gnu-system.am (GNU_SYSTEM_MODULES): Add it.
* guix.texi ("Web Services"): New section.
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi21
1 files changed, 21 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index 88e1ff7f77..2973411beb 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -5592,6 +5592,7 @@ declaration.
 * X Window::                    Graphical display.
 * Desktop Services::            D-Bus and desktop services.
 * Database Services::           SQL databases.
+* Web Services::                Web servers.
 * Various Services::            Other services.
 @end menu
 
@@ -6111,6 +6112,26 @@ The PostgreSQL daemon loads its runtime configuration from
 @var{data-directory}.
 @end deffn
 
+@node Web Services
+@subsubsection Web Services
+
+The @code{(gnu services web)} module provides the following service:
+
+@deffn {Monadic Procedure} nginx-service [#:nginx nginx] @
+       [#:log-directory ``/var/log/nginx''] @
+       [#:run-directory ``/var/run/nginx''] @
+       [#:config-file]
+
+Return a service that runs @var{nginx}, the nginx web server.
+
+The nginx daemon loads its runtime configuration from @var{config-file}.
+Log files are written to @var{log-directory} and temporary runtime data
+files are written to @var{run-directory}.  For proper operation, these
+arguments should match what is in @var{config-file} to ensure that the
+directories are created when the service is activated.
+
+@end deffn
+
 @node Various Services
 @subsubsection Various Services