Loading a module to nginx

Legacy Knowledge Base

Published Jun. 30, 2025

Loading a module to nginx

Written By

Jorge García Jiménez

Legacy Article

You are viewing an article from our legacy "FastTrack" publication program, made available for informational purposes. Articles in this program were published without a requirement for independent editing or verification and are provided"as is" without guarantee.

Before using any information from this article, independently verify its suitability for your situation and project.

Note: please note that Liferay has renamed its Liferay Experience Could offerings to Liferay SaaS (formerly LXC) and Liferay PaaS (formerly LXC-SM).

Issue

We need to load a module for restricting IP accesses from certain places. We need to enable "ngx_http_geoip_module" to achieve this behavior.
If we set the directive "load_module modules/ngx_http_geoip_module.so;" into liferay.conf file we get the following error
```
"load_module" directive is not allowed here in /etc/nginx/conf.d/liferay.conf:1
```

Environment

Liferay PaaS, Liferay DXP 7.2 with stack 5.x

Resolution

In order to load modules in nginx you have to modify either nginx.conf, or add a new config file in below path:
```
/webserver/config/{env}/myfile.conf
```
This way, the load_module directive will be correctly processed and the module will be loaded into your webserver service.