NGINX Mercurial Proxy on Windows

In my previous article I explained how to setup Mercurial 4.5+ as a Windows Service. In this article we will expand on that configuration, and use NGINX to proxy to the service.

Note: This is supposed to make the service faster. However in my testing, I found it slower. This does allow you to use other functionality like LDAP, and AD authentication which is not available to our Mercurial service.



  1. I am partial to installing the nginx server by unzipping the file to  C:\nginx-1.13.12. This helps us to avoid any path related issues.
  2. Next, we will install the WinSW file to the nginx directory.
  3. Rename the WinSW executable to nginx-service.exe.
  4. Create an XML file called nginx-service.xml. Modify it as shown below.
  5. Run nginx-service.exe install to install the service
  6. The conf/nginx.conf needs to be modified to point to our mercurial service. You will need to modify server_name and listen to match your environment. Please see the example below.
  7. The Mercurial service we installed earlier is set to startup and listen on all IP interfaces by default ( We want to modify this to bind to localhost. This will prevent the service from being exposed except through our NGINX. This is accomplished by changing the line in the hg-service.bat to the following: "C:\Python27\Scripts\hg.exe" serve --address localhost --web-conf C:\hg\hgweb.config
  8. Start the service and enjoy.


    <description>nginx web server.</description>


We need to add a location to the file to proxy the connection to our Mercurial service.

worker_processes 1;
events {
    worker_connections 1024;

http {
    include mime.types;
    default_type application/octet-stream;
    sendfile on;
    keepalive_timeout 65;

    server {
        listen 8080;

    location / {
        proxy_pass http://localhost:8000;

        error_page 500 502 503 504  /50x.html;
        location = /50x.html {
            root html;

#    server {
#        listen 443 ssl;
#        server_name;

#        ssl_certificate server.pem;
#        ssl_certificate_key server.key;

#        ssl_session_cache shared:SSL:1m;
#        ssl_session_timeout 5m;

#        ssl_ciphers HIGH:!aNULL:!MD5;
#        ssl_prefer_server_ciphers on;

#   location / {
#       proxy_pass http://localhost:8000;
#       }
#   }

Mercurial on NGINX