how to install nginx_substitutions_filter in existing Nginx

Francis Daly francis at
Tue Jun 6 17:21:49 UTC 2017

On Tue, Jun 06, 2017 at 12:27:04AM -0400, David Woodstuck wrote:

Hi there,

> I am a new Nginx user. I just install Nginx 1.12. I like to
> use nginx_substitutions_filter. I cannot figure out how to install
> nginx_substitutions_filter in previously existing Nginx.

You (probably) don't.

describes how to build from source in general;

describes how to include the modules you mention, in specific.

> Should I unstall Nginx first?

You can run "nginx -V" to see the "configure" arguments that were used
to create your current version. Then add the extra bits that you want.

Depending on precisely how you installed your current nginx, you probably
*do* want to uninstall it before installing the new one.

If your current nginx supports dynamic modules (1.12 does), and if
this extra module you want supports being built as a dynamic module,
then you may be able to build-and-add the module.

I suspect that in your case, you will probably find more clear
documentation on how to build-and-maintain a new nginx than how to
build-and-maintain the extra module.

I also suspect that, based on parallel mail threads, you probably do
not need the extra module.

It is still useful to know how to add a module that you want, so it is
certainly worth trying it on a test system, at least.

Good luck with it,

Francis Daly        francis at

More information about the nginx mailing list