Configuring a proxy (Nginx)

When configuring PageSeeder on Linux if a website port less than 1024 (e.g. 80 or 443 for SSL) is chosen, then a reverse proxy from this port to the API port (e.g. 8282) needs to be configured. This is because the PageSeeder service is not running as the root user so does not have access to these lower port numbers.

We recommend using Nginx as a reverse proxy as it is open source and easy to configure. Below are instructions on how to do this.

Install Nginx

To add nginx yum repository, create a file named /etc/yum.repos.d/nginx.repo and paste the configuration below for CentOS or something similar for the operating system.

CentOS:

[nginx]
name=nginx repo
baseurl=http://nginx.org/packages/centos/$releasever/$basearch/
gpgcheck=0
enabled=1

Then enter:

yum install nginx

Configure Nginx

1. Backup the original nginx.config:

   mv /etc/nginx/nginx.conf /etc/nginx/nginx.conf.orig
   

2. Create a new file /etc/nginx/nginx.conf and paste the configuration below for non-SSL or SSL into it. Substitute your domain name for myserver.mycompany.com, your website port for 80 and your API port for 8282. If using SSL, see Configuring SSL. To bind PageSeeder to a single IP address, substitute 80 or 443 with [your ip]:80 or [your ip]:443.
   Non-SSL:

   user nginx;
   
   events {
       worker_connections  1024;
   }
   
   http {
     include       /etc/nginx/mime.types;
     server {
       listen               80;
       server_name          myserver.mycompany.com;    
       client_max_body_size 1000m;
       location / {
         proxy_pass                   http://localhost:8282;
         proxy_set_header Host        $host;
         proxy_set_header X-Real-IP   $remote_addr;
         proxy_set_header X-Scheme    $scheme;
       }
       error_page 502 =503  /ps/maintenance/maintenance.html;
       location /ps/maintenance/ {
         root               /var/www;
       }
     }
   }
   

   SSL:

   user nginx;
   
   events {
       worker_connections  1024;
   }
   
   http {
     include       /etc/nginx/mime.types;
     server {
       listen               443 ssl;
       server_name          myserver.mycompany.com;
       client_max_body_size 1000m;
       ssl_certificate      /etc/nginx/ssl/pageseeder/mydomain.crt;
       ssl_certificate_key  /etc/nginx/ssl/pageseeder/mydomain.key;
       ssl_session_cache    shared:SSL:10m;
       ssl_session_timeout  10m;
       ssl_protocols        TLSv1 TLSv1.1 TLSv1.2;
       location / {
         proxy_pass                   http://localhost:8282;
         proxy_set_header Host        $host;
         proxy_set_header X-Real-IP   $remote_addr;
         proxy_set_header X-Scheme    $scheme;
         proxy_cookie_path /ps/       "/ps/; Secure";
       }
       error_page 502 =503  /ps/maintenance/maintenance.html;
       location /ps/maintenance/ {
         root               /var/www;
       }
     }
     server {
       listen                80;
       return 301            https://$host$request_uri;
     }
   }
   

3. Copy the PageSeeder maintenance page to nginx as follows:

   mkdir -p /var/www/ps
   cp -r /opt/pageseeder/webapp/maintenance /var/www/ps/
   

4. Start nginx and make it start automatically at reboot.

   service nginx start
   chkconfig --add nginx
   

proxy_read_timeout  300s;

Created on 12 September 2014 , last edited on 03 May 2017 at 13:10