NOTE: This repository is deprecated. JupyterHub now supports alternate proxy implementations directly: http://jupyterhub.readthedocs.io/en/latest/api/proxy.html
A replacement for configurable-http-proxy that uses nginx+lua instead of NodeJS.
It needs a version of nginx with the Lua module installed. It also requires the lua cjson package installed.
On most Debian / Ubuntu systems, just installing the following packages should be enough:
sudo apt-get install nginx-extras lua-cjson
You can install it easily via pip:
pip install nchp
The simplest way to use it is to just let jupyterhub manage it directly. You can pass jupyterhub the path to the proxy it should start by either commandline:
--JupyterHub.proxy_cmd='/usr/local/bin/nchp'
or by adding the following line to your jupyterhub_config.py:
c.JupyterHub.proxy_cmd='/usr/local/bin/nchp'
This assumes that /usr/local/bin/nchp is the path to the nchp script. You can verify this by running which nchp on the commandline after installing it to find the full path.