logo
Free, unlimited AI code reviews that run on commit
git-lrc git-lrc GitHub Install Now We'd appreciate a star git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt git-lrc - Free, unlimited AI code reviews that run on commit | Product Hunt

dh_nginx - register configuration snippets to the nginx web server

Author

       This  manual  and  dh_nginx  was  written  by  Christos  Trochalakis.   dh_nginx  is heavily influnced by
       dh_apache2 written by Arno Toell <debian@toell.net>.

perl v5.40.1                                       2025-05-27                                        DH_NGINX(1)

Description

dh_nginx is a debhelper program that is responsible for correctly installing Nginx configuration snippets
       and setting postinst, prerm and dependencies in Nginx web server modules and web applications.

       It supports the following configuration types

       •   Nginx modules

Files

       debian/package.nginx
       debian/nginx

       Lists  files  to be registered with the Nginx HTTP server. The file is interpreted as line separated list
       of installation stanzas, where each entry consists of whitespace separated values conforming to the  file
       semantics below.

       When this file is missing but the name of the package looks like a nginx module, the module load file and
       its  loading  priority is automatically generated inferring from the package name. In this case, package-name.install or other mechanisms should be used for copying the .so library into the correct place.

   FILESEMANTICS
       Each line consists of a triple

       typefile [arguments]

       where the values are interpreted as follows:

       type

       Denotes the type of file to be installed. Recognized values are mod for Nginx modules.

       file

       Is interpreted as existing file name within the source package. No path expansion  is  effectuated.  Just
       like dh_install(1), dh_nginx can not rename files.

       arguments

       Is inrerpreted as optional arguments if any, currently not used.

   MODULES
       Modules  are  handled  specially and are determined by the mod type. Modules must have a .conf suffix. In
       that case the file is interpreted as module load file and is installed  to  /etc/nginx/modules-available.
       If the file is ending with a .so suffix it is interpreted as actual module shared object and is installed
       to  the  Nginx  module  directory, an optional numeric priority can be set as the last argument to handle
       module dependencies.

Invocation

         %:
            dh $@ --with nginx

Name

       dh_nginx - register configuration snippets to the nginx web server

Notes

       Note that this command is not idempotent.  dh_prep(1)  should  be  called  between  invocations  of  this
       command. Otherwise, it may cause multiple instances of the same text to be added to maintainer scripts.

Options

-e, --noenable
           Install maintainer scripts accordingly, but do not enable the scripts or configuration by default.

       -n, --noscripts
           Do not modify postinst/postrm/prerm maintainer scripts.

       --in-nginx-tree
           Specify this option when building in-tree modules along with nginx. When specified, nginx abi version
           is not required in package name.

Synopsis

dh_nginx [debhelperoptions] [-n|--noscripts] [--in-nginx-tree]

See Also