Alternative STINGAR Installation Methods

If your system requirements differ from our recommended approach (i.e. Ubuntu/CentOS/RHEL with docker / docker-compose) there are alternative technologies that will also allow you to install STINGAR but require some manual editing of the 3 configuration files created by the quickstart script: stingar.env nginx.conf docker-compose.yml
This approach will allow you to install and run STINGAR web dashboard but will have some limitations on the automatic deployment of honeypots.

Podman / podman-compose

Podman is an alternative to Docker which doesn't require sudo access to your host. It does, however, limit the port mappings of your host to >1024. Hence you will need to point your browser at a specific port number (above 1024) to access the STINGAR web dashboard.

In this wallkthrough example we will use port 8443 instead of the default 443: (ensure your firewall settings allow inbound traffic from ports 8443, 8080, 24224.

STEP 1) You will need to edit your nginx.conf file to update the listen ports and port mapping settings :

change lines ~36/37 of nginx.conf to :

listen [::]:8443 ssl ipv6only=on; # managed by Certbot
listen 8443 ssl; # managed by Certbot

and change line ~106 to:

proxy_set_header  X-Forwarded-Host $host:$server_port; # append ':$server_port' to '$host' 

STEP 2) edit the docker-compose.yml file to update the port mappings and file permissions of the web container

change lines ~74/75 of docker-compose.yml to :

    82    web:
    83      image: nginx
    84      container_name: nginx
    85      ports:
    86        - 8080:80
    87        - 8443:8443
    88      volumes:
    89        - ./certs:/etc/nginx/conf.d:z
    90        - ./stingar-nginx/nginx.conf:/etc/nginx/nginx.conf:ro,Z
    91      restart: on-failure

modify & re-save the file

STEP 3) edit the stingar.env file to update these 2 environment variables:

change line ~44 of stingar.env to :

API_HOST=http://stingarapi.dns.podman:8000/

and change line ~69 of stingar.env to :

STINGAR_SERVICE_URL=http://stingarapi.dns.podman:8000/api/v2

NOTE: ensure there are no trailing spaces on these two lines

modify & re-save the file -

STEP 4) then start the current enviroment

% podman-compose up -d

& then point your browser at the correct port https://localhost:8443