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 :

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

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

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