How to configure AWStats web-interface

I will show you how to configure AWStats web-interface using uWSGI application server and nginx HTTP server which is a very simple and straightforward process.

Configure AWStats

Install AWStats package.

$ sudo apt-get install awstats

Configure it according to your needs. I will leave it up to you to perform this step as it is specific to your setup.

I am using global /etc/awstats/awstats.conf.local override file to use HTML frames, display top menu and allow to initiate update process directly from browser.

$ sudo cat awstats.conf.local
# You can overrides config directives here.
# This is particularly useful for users with several configs for
# different virtual servers, who want to reuse common parameters.
# Also, this file is not updated with each new upstream release.

# use frames

# show top menu (last update, reported period, filters, initiate update)

# allow to initiate update from browser an use lock file

Install uWSGI

Install uWSGI package.

$ sudo apt-get --no-install-recommends install uwsgi

Configure uWSGI application

Define AWStats application.

$ cat << EOF | sudo tee /etc/uwsgi/apps-available/awstats.ini
plugins      = router_basicauth, cgi
route        = ^/ basicauth:awstats,secret-user:secret-password
uid          = www-data
gid          = www-data
processes    = 1
threads      = 2
cgi           = /usr/lib/cgi-bin/
chown-socket = www-data:www-data

I have added basic authentication (user secret-user and password secret-password) to protect statistics. You can use htpasswd file or utilize HTTP server to take care of the authentication process.

Enable application.

$ sudo ln -s /etc/uwsgi/apps-available/awstats.ini /etc/uwsgi/apps-enabled/

Reload application server configuration.

$ sudo systemctl restart uwsgi

Install nginx

Install nginx package.

$ sudo apt-get install nginx

Configure nginx

Disable default nginx site.

$ sudo unlink /etc/nginx/sites-enabled/default

Prepare nginx virtual host configuration ( in this example).

$ cat << EOF | sudo tee /etc/nginx/sites-available/
server {
  listen 80;

  location / {
    include uwsgi_params;
    uwsgi_modifier1 9;
    uwsgi_pass unix:/var/run/uwsgi/app/awstats/socket;

    rewrite ^/\$ \$scheme:// permanent;

  location /awstats-icon/ {
    alias /usr/share/awstats/icon/;
    expires 30d;
Notice the rewrite rule to open default awstats configuration.

Enable virtual host.

$ sudo ln -s /etc/nginx/sites-available/ /etc/nginx/sites-enabled/

Reload HTTP server configuration.

$ sudo systemctl reload nginx

It is as simple as that.


The uWSGI project

The uWSGI project - The uwsgi Protocol

The uWSGI project - uWSGI internal routing

Milosz Galazka's Picture

About Milosz Galazka

Milosz is a Linux Foundation Certified Engineer working for a successful Polish company as a system administrator and a long time supporter of Free Software Foundation and Debian operating system.

Gdansk, Poland