Amazon Linux NGINX 1.14.1+

Requirements

Our distribution release depends on the EPEL repository. You will need to ensure your system also has it installed.

Add the package repositories

Add the version of the NGINX package repository that you want to use:

NGINX version 1.18.0+ running either Amazon Linux 2 / Amazon Linux 2018.03

sudo tee /etc/yum.repos.d/sigsci.repo <<-'EOF'
[sigsci_release]
name=sigsci_release
baseurl=https://yum.signalsciences.net/release/el/7/$basearch
repo_gpgcheck=1
gpgcheck=1
enabled=1
gpgkey=https://yum.signalsciences.net/release/gpgkey
      https://dl.signalsciences.net/sigsci-agent/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
EOF

NGINX version 1.14.1 < 1.17.9 on Amazon Linux 2

sudo tee /etc/yum.repos.d/sigsci.repo <<-'EOF'
[sigsci_release]
name=sigsci_release
baseurl=https://yum.signalsciences.net/release/el/7/$basearch
repo_gpgcheck=1
gpgcheck=1
enabled=1
gpgkey=https://yum.signalsciences.net/release/gpgkey https://dl.signalsciences.net/sigsci-agent/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
EOF

NGINX version 1.14.1 < 1.17.9 on Amazon Linux 2018.03

Note: After Q2 2017, RHEL6 and CentOS 6 will exit “Production Phase 2” according to the Red Hat Enterprise Linux Life Cycle. Only limited “critical” security fixes will be issued. You will need to review the lifecycle document for details and plan appropriately.

sudo tee /etc/yum.repos.d/sigsci.repo <<-'EOF'
[sigsci_release]
name=sigsci_release
baseurl=https://yum.signalsciences.net/release/el/6/$basearch
repo_gpgcheck=1
gpgcheck=1
enabled=1
gpgkey=https://yum.signalsciences.net/release/gpgkey https://dl.signalsciences.net/sigsci-agent/gpg.key
sslverify=1
sslcacert=/etc/pki/tls/certs/ca-bundle.crt
EOF

Install the NGINX module

1. Install the Signal Sciences NGINX module by running the following command, replacing “NN.NN” with your NGINX version number:

   • NGINX version 1.18.0+ running either Amazon Linux 2 / Amazon Linux 2018.03

     sudo yum install nginx-module-sigsci-nxo-1.NN.NN*
     

   • NGINX version 1.14.1 < 1.17.9 on Amazon Linux 2 / Amazon Linux 2018.03

     sudo yum install nginx-module-sigsci-nxo-amzn-1.NN.NN*
     

2. In your NGINX config file (located by default at /etc/nginx/nginx.conf) add the following lines to the global section after the pid /run/nginx.pid; line:

   load_module /etc/nginx/modules/ngx_http_sigsci_module.so;
   

3. Restart the NGINX service to initialize the new module.

   • Amazon Linux 2

     systemctl restart nginx
     

   • Amazon Linux 2018.03

     restart nginx