$OpenBSD: README,v 1.5 2018/09/04 12:46:24 espie Exp $

+-----------------------------------------------------------------------
| Running awstats on OpenBSD
+-----------------------------------------------------------------------

The configuration is prepared to produce reports for localhost.
To generate reports execute either on the command line or from cron:

    # /var/www/awstats/wwwroot/cgi-bin/awstats.pl -config=localhost -update


To use awstats with nginx, create a symbolic link in the htdocs directory:

    # ln -s ../awstats/wwwroot awstats

Add this configuration example to /etc/nginx/nginx.conf:

    location ~ ^/awstats/cgi-bin/(.+\.pl)(.*)$ {
        fastcgi_pass            unix:run/slowcgi.sock;
        fastcgi_split_path_info ^/awstats/cgi-bin/(.+\.pl)(.*)$;
        fastcgi_param           SCRIPT_FILENAME /var/www/awstats/wwwroot/cgi-bin/$fastcgi_script_name;
        fastcgi_param           PATH_INFO $fastcgi_path_info;
        include                 fastcgi_params;
    }

Enable and start nginx:

    # rcctl enable nginx
    # rcctl start nginx

Enable, set flags to disable chroot(2) and start slowcgi(8):

    # rcctl enable slowcgi
    # rcctl set slowcgi flags -p /
    # rcctl start slowcgi

To access the reports for localhost point your browser to:

    http://localhost/awstats/cgi-bin/awstats.pl?config=localhost
