Installation with Ubuntu

The following is intended for reference or installing within a Development or Testing environment.

Ubuntu 14.04
Ubuntu 16.04+

Ubuntu 14.04

1. Add the official NGINX repository

NOTE: An official version of NGINX is required to guarantee support of all required dependencies of the PerimeterX Lua Module

sudo add-apt-repository ppa:nginx/stable

If the following error is returned add-apt-repository: command not found, run the following and try again.

sudo apt-get -y install software-properties-common

2. Upgrade/Update existing dependencies for Ubuntu 14.04

sudo apt-get update
sudo apt-get upgrade

3. Install the dependencies for Ubuntu 14.04:

sudo apt-get -y install build-essential
sudo apt-get -y install ca-certificates
sudo apt-get -y install make
sudo apt-get -y install wget
sudo apt-get -y install nginx
sudo apt-get -y install m4
sudo apt-get -y install libnginx-mod-http-lua
sudo apt-get -y install lua-cjson

4. Download and install LuaRocks from source

wget http://luarocks.github.io/luarocks/releases/luarocks-2.4.4.tar.gz
tar -xzf luarocks-2.4.4.tar.gz
cd luarocks-2.4.4
./configure
sudo make clean && sudo make build && sudo make install
cd ~

5. Download and install Nettle 3.3 from source

wget https://ftp.gnu.org/gnu/nettle/nettle-3.3.tar.gz
tar -xzf nettle-3.3.tar.gz
cd nettle-3.3
./configure
sudo make clean && sudo make install
cd ~

6. Install the remaining dependencies

sudo apt-get -y install lua-sec
luarocks install lua-resty-upload

7. Install the PerimeterX NGINX Plugin

sudo no_proxy=1 luarocks install perimeterx-nginx-plugin

Ubuntu 16.04+

1. Add the official NGINX repository

sudo add-apt-repository ppa:nginx/stable

If the following error is returned add-apt-repository: command not found, run the following and try again.

sudo apt-get -y install software-properties-common

##2. Update/Upgrade your existing dependencies for Ubuntu 16.04+

sudo apt-get update
sudo apt-get upgrade

3. Install the dependencies for Ubuntu 16.04+

sudo apt-get -y install build-essential
sudo apt-get -y install ca-certificates
sudo apt-get -y install nginx
sudo apt-get -y install libnginx-mod-http-lua
sudo apt-get -y install lua-cjson
sudo apt-get -y install libnettle6
sudo apt-get -y install nettle-dev
sudo apt-get -y install luarocks
sudo apt-get -y install luajit
sudo apt-get -y install libluajit-5.1-dev

4. Install the PerimeterX NGINX Plugin

luarocks install perimeterx-nginx-plugin

Did this page help you?