Scroll to navigation

DH_NGINX(1) User Contributed Perl Documentation DH_NGINX(1)


dh_nginx - register configuration snippets to the nginx web server


dh_nginx [debhelper options] [-n|--noscripts] [--in-nginx-tree]


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


     dh $@ --with 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.


Each line consists of a triple

type file [arguments]

where the values are interpreted as follows:


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


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.


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


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.


Install maintainer scripts accordingly, but do not enable the scripts or configuration by default.
Do not modify postinst/postrm/prerm maintainer scripts.
Specify this option when building in-tree modules along with nginx. When specified, nginx abi version is not required in package name.


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.


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

2022-07-23 perl v5.34.0