= How do i set up `awstats` for a member? =

These instructions are for MF/PL system administrators to setup awstats for members.  You can't run them as a regular user (though [ticket:763 there is discussion about changing that]).

[http://awstats.sourceforge.net awstats] is a real-time logfile analyzer to get advanced statistics about the traffic visiting a web site.

Run (as root): 

{{{
mf-awstats-create
}}}

After confirming that you want to run the script, you will get a session like the following:

{{{
Please enter the user that you want the cron job to run as. This should be
the primary user for the hosting order. [] btp
You entered: btp

Thanks. Press enter to continue [y] 
Adding password for user btp
Please add the following lines to this users web config (via Red):          <--- this means via de Control Panel, where you will be able to add them to your https configs too, if you'd prefer
Alias /stats /home/members/jfrej/sites/beyondthepale.org/.red/awstats/web
<Directory /home/members/jfrej/sites/beyondthepale.org/.red/awstats/web >
  AllowOverride AuthConfig
</Directory>

And tell them that they can log in to:
http://beyondthepale.org/stats/                                              <--- or https://beyondthepale.org/stats/
With:
user: btp
pass: XXXXXXX
Generating initial stats. Please wait. This may take a few minutes.
Running: su -c '/usr/local/sbin/mf-awstats-build-staticpages 'beyondthepale.org' '/home/members/jfrej/sites/beyondthepale.org/.red/awstats/web'' btp
0 jm@mandela:~$
}}}