Using Nginx

To expose the services via web Nginx can be used.

Configuration example:

upstream immortal {
    server unix:/var/run/immortal/sleep/immortal.sock;

server {
listen 80 default_server;
server_name _;
location / {
    proxy_set_header X-Real-IP $remote_addr;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header Host $http_host;
    proxy_set_header X-NginX-Proxy true;
    proxy_http_version 1.1; # for keep-alive
    proxy_pass http://immortal/;
    proxy_redirect off;

Based on the setup, permissions for the socket may need to be changed:

$ chmod 766 /var/run/immortal/<service name>/immortal.sock

To check the service status:


To send signals:


For example to stop the service:


To start the service:


The responses are in JSON format.

comments powered by Disqus