How to Deploy Modsecurity with Nginx on Ubuntu 20.04 LTS

Security is a fundamental aspect of every sysadmin’s job. Especially if you have public websites or web applications hosted with Nginx on your server. That’s why today we present you this post, where you will learn how to deploy ModSecurity with Nginx in Ubuntu 20.04.

mod_security is an Apache security module, it acts as a web application firewall (WAF) and its job is to filter and block suspicious HTTP requests. This makes it possible to prevent brute force attacks and so on.

Although it is an Apache module, we can install and deploy it for Nginx. That’s the reason for our post.

Let’s get started.

Some considerations

Before we start, we need to know a few things. It is recommended that the server does not have many applications installed. Even if we are on a fresh installation, much better. This is also why it is recommended that we don’t have nginx installed on the system.

In addition to this, we need to use sudo or the root account.

Installing the latest stable version of Nginx on Ubuntu 20.04

It is recommended to install Mod_security using the latest version of Nginx. To do so, we have to install it using the ondrej PPA for Ubuntu 20.04.

Update the server completely

sudo apt update
sudo apt upgrade

Then add the repository

sudo add-apt-repository ppa:ondrej/nginx-mainline

Refresh APT.

sudo apt update

Finally, install Nginx by running

sudo apt install nginx-core nginx-common nginx nginx nginx-full

Next, you can check the version of Nginx by running

nginx -V

The next step is to enable the source code repository of the PPA we enabled. This is necessary because we will be downloading the Nginx source code later.

To achieve this, open the repository configuration file

sudo nano /etc/apt/sources.list.d/ondrej-ubuntu-nginx-mainline-*.list

And look for the line

#deb-src focal main

Remove the # at the beginning. It will look like this:

deb-src focal main

Save the changes and close the editor. Finally, refresh APT.

sudo apt update

Download the Nginx source package using APT

First, let’s set the /usr/local/src/ folder to belong to the regular system user.

sudo chown user:user /usr/local/src/` -R 

And now create the folder where the sources will be.

mkdir -p /usr/local/src/nginx

Access it

cd /usr/local/src/nginx/

From here install the dpkg-dev package

sudo apt install dpkg-dev

And download the Nginx source files

apt source nginx

If you run the ls command, you will see something similar to this

Nginx source code on Ubuntu 20.04
Nginx source code on Ubuntu 20.04

Install libmodsecurity3

Now we need to install the modsecurity library. It is available in the official Ubuntu 20.04 repositories. However, it is recommended to compile it from source.

To achieve this, install Git in Ubuntu 20.04

sudo apt install git

Then clone the Mod_security repository

git clone --depth 1 -b v3/master --single-branch /usr/local/src/ModSecurity/

You will get an output screen like this

Cloning into '/usr/local/src/ModSecurity'...
remote: Enumerating objects: 840, done.
remote: Counting objects: 100% (840/840), done.
remote: Compressing objects: 100% (808/808), done.
remote: Total 840 (delta 496), reused 119 (delta 24), pack-reused 0
Receiving objects: 100% (840/840), 762.19 KiB | 978.00 KiB/s, done.
Resolving deltas: 100% (496/496), done.

Then access the folder where it was downloaded.

cd /usr/local/src/ModSecurity/

Thereafter, you have to install all the dependencies needed for the compilation.

sudo apt install gcc make build-essential autoconf automake libtool libcurl4-openssl-dev liblua5.3-dev libfuzzy-dev ssdeep gettext pkg-config libpcre3 libpcre3-dev libxml2 libxml2-dev libcurl4 libgeoip-dev libyajl-dev doxygen

And run these commands to refresh the necessary modules

git submodule init
git submodule update

Now it remains to compile it


During the execution of these commands, you will get the following error

fatal: No names found, cannot describe anything.

Ignore it

Now we have to compile it using make.

make -j2

If you have more CPU Cores, you can replace 2 by the number of cores you want to be used in the process. The more, the shorter the time required.

When finished, we have to install it.

sudo make install

Install ModSecurity with Nginx

This connector that we are going to install is the one in charge of linking the previous library with Nginx. So let’s go for it.

Clone the repository to have the latest version available.

git clone --depth 1 /usr/local/src/ModSecurity-nginx/

Access the folder where the Nginx sources are located.

cd /usr/local/src/nginx/nginx/nginx-1.21.6/

And from there install the Nginx dependencies.

sudo apt build-dep nginx

Next install the uuid-dev package

sudo apt install uuid-dev

Now configure it to generate the connector.

./configure --with-compat --add-dynamic-module=/usr/local/src/ModSecurity-nginx

Compile and generate the module

make modules

And copy it to the folder where the Nginx modules are located

sudo cp objs/ /usr/share/nginx/modules/

Thereafter, you need to load it to Nginx. To achieve this, edit the Nginx configuration file.

sudo nano /etc/nginx/nginx.conf

And add the following to the beginning of the file before the http section

sudo nano /etc/nginx/nginx.conf

Then in the http{ section add the following

modsecurity on;
modsecurity_rules_file /etc/nginx/modsec/main.conf;

Save your changes and close the editor.

Now you have to create the folder where the module configuration will work.

sudo mkdir /etc/nginx/modsec/

Copy the recommended configuration to this folder to apply it.

sudo cp /usr/local/src/ModSecurity/modsecurity.conf-recommended /etc/nginx/modsec/modsecurity.conf

Now edit this configuration file

sudo nano /etc/nginx/modsec/modsecurity.conf

There, look for the line

SecRuleEngine DetectionOnly line

And replace it with

SecRuleEngine On

Also look for

SecAuditLogParts ABIJDEFHZ

And replace it with this


Also search for SecResponseBodyAccess and set it to Off.

SecResponseBodyAccess Off

Save the changes and close the editor.

Now create the file /etc/nginx/modsec/main.conf.

sudo nano /etc/nginx/modsec/main.conf

Then add the following line

Include /etc/nginx/modsec/modsecurity.conf

You need to copy the unicode mapping file as well

sudo cp /usr/local/src/ModSecurity/unicode.mapping /etc/nginx/modsec/

To apply all changes, you have to restart Nginx.

sudo systemctl restart nginx

With this, the installation is complete, but we have to add some rules.

Enable OWASP rules

Even though we already have mod_security on the system, it’s no good if we don’t have some rules defined. So let’s install a set of community-maintained rules that can be a great starting point.

Download them using wget


Unzip the archive

tar xvf v3.3.0.tar.gz

Now move the generated directory to /etc/nginx/modsec/ folder

sudo mv coreruleset-3.3.0/ /etc/nginx/modsec/`.

Now enable the sample configuration by renaming it to

sudo mv /etc/nginx/modsec/coreruleset-3.3.0/crs-setup.conf.example /etc/nginx/modsec/coreruleset-3.3.0/crs-setup.conf

In the configuration file, we have to enable these rules.

sudo nano /etc/nginx/modsec/main.conf

Add these lines to the file

Include /etc/nginx/modsec/coreruleset-3.3.0/crs-setup.conf
Include /etc/nginx/modsec/coreruleset-3.3.0/rules/*.conf

Save the changes and close the editor.

To finish and apply all the changes, you need to restart Nginx.

sudo systemctl restart nginx

You can check the status of Nginx

sudo systemctl status nginx
ModSecurity with Nginx
ModSecurity with Nginx

This is enough.

One last thing…

Before we say goodbye, if you upgrade Nginx using APT as usual, it will cause Mod_security to fail, and you will lose all your work. So, I recommend you use this command

sudo apt-mark hold nginx

This way, APT will not update it.

ModSecurity with Nginx – Conclusion

Website security is not something to be taken lightly, that’s why there are tools like mod_security, and today you have learned how to install it.

1 thought on “How to Deploy Modsecurity with Nginx on Ubuntu 20.04 LTS”

Leave a Comment

Your email address will not be published. Required fields are marked *

Scroll to Top