diff options
| author | Sören Tempel <soeren+git@soeren-tempel.net> | 2026-05-16 13:57:23 +0200 |
|---|---|---|
| committer | Sören Tempel <soeren+git@soeren-tempel.net> | 2026-05-17 17:59:35 +0200 |
| commit | 258cabed3285ec66893cc83ae704a40d57fec9ac (patch) | |
| tree | c442e33b0fcea12c7b621160474294992d4e4107 /doc | |
| parent | 28b1f28153439e47c141231549a1b809af291261 (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.texi | 9 |
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). | |||
| 36232 | A list of sockets (as path strings) which gunicorn will be listening | 36232 | A list of sockets (as path strings) which gunicorn will be listening |
| 36233 | on. This list must contain at least one socket. | 36233 | on. This list must contain at least one socket. |
| 36234 | 36234 | ||
| 36235 | @item @code{socket-user} (default: @code{user}) (type: string) | ||
| 36236 | Owner of the directory containing the socket (must be an existing user). | ||
| 36237 | |||
| 36238 | @item @code{socket-group} (default: @code{group}) (type: string) | ||
| 36239 | Group owner of the directory containing the socket (must be an existing group). | ||
| 36240 | |||
| 36241 | @item @code{socket-mode} (default: @code{#o750}) (type: integer) | ||
| 36242 | File 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) |
| 36236 | The number of workers for the gunicorn app. | 36245 | The number of workers for the gunicorn app. |
| 36237 | 36246 | ||
