summaryrefslogtreecommitdiff
path: root/doc
diff options
context:
space:
mode:
authorSören Tempel <soeren+git@soeren-tempel.net>2026-05-16 13:57:23 +0200
committerSören Tempel <soeren+git@soeren-tempel.net>2026-05-17 17:59:35 +0200
commit258cabed3285ec66893cc83ae704a40d57fec9ac (patch)
treec442e33b0fcea12c7b621160474294992d4e4107 /doc
parent28b1f28153439e47c141231549a1b809af291261 (diff)
services: gunicorn: Allow configuration of socket user/group/mode
Without this change, the mode is not at all configurable meaning that—depending on the umask(1)—it may allow access to others. Further, in many scenarios the owner/group of the Unix domain socket should differ from the owner/group of the gunicorn process. For example, we might want to grant the nginx group access to the socket but not use that as the GID for the gunicorn process. * gnu/services/web.scm (<gunicorn-app>): Add socket-user, socket-group and socket-mode. * gnu/services/web.scm (gunicorn-activation): Respect gunicorn-app-socket-user, gunicorn-socket-app-group, and gunicorn-app-socket-mode. * doc/guix.texi (Guix Services): Document new record fields. Change-Id: I1fe5b77deb791c38c1642753a52098d304124049
Diffstat (limited to 'doc')
-rw-r--r--doc/guix.texi9
1 files changed, 9 insertions, 0 deletions
diff --git a/doc/guix.texi b/doc/guix.texi
index d228d26b0cc..4ba4b650de7 100644
--- a/doc/guix.texi
+++ b/doc/guix.texi
@@ -36232,6 +36232,15 @@ Launch the app as this group (it must be an existing group).
36232A list of sockets (as path strings) which gunicorn will be listening 36232A list of sockets (as path strings) which gunicorn will be listening
36233on. This list must contain at least one socket. 36233on. This list must contain at least one socket.
36234 36234
36235@item @code{socket-user} (default: @code{user}) (type: string)
36236Owner of the directory containing the socket (must be an existing user).
36237
36238@item @code{socket-group} (default: @code{group}) (type: string)
36239Group owner of the directory containing the socket (must be an existing group).
36240
36241@item @code{socket-mode} (default: @code{#o750}) (type: integer)
36242File mode to use for the directory containing the socket.
36243
36235@item @code{workers} (default: @code{1}) (type: integer) 36244@item @code{workers} (default: @code{1}) (type: integer)
36236The number of workers for the gunicorn app. 36245The number of workers for the gunicorn app.
36237 36246