AWSTATS(1)

💖 AWSTATS 💖

okay bestie, sit down, hydrate, because we're about to talk about awstats — a free web server logfile analyzer that shows you advanced web statistics ✨. that's it, that's the whole vibe. this is the awstats page from the General Commands Manual, and yes she's iconic 👑

---

🌸 SYNOPSIS 🌸

awstats -config virtualhostname [ options ]

that's the shape of it, babes. -config and a virtualhost name, then whatever options your heart desires 🫶

---

🦋 DESCRIPTION 🦋

so basically, this runs awstats on the command line, and it does one of two things:

• it updates the statistics (-update option) of a web site, pulling from the log file that's defined in the AWStats config file, or
• it builds an HTML report (-output option) 💅

and here's the little detective work she does to find her config, in order, no cap:

1. first, awstats tries to read awstats.virtualhostname.conf as the config file.
2. if that's not found, awstats tries to read awstats.conf.
3. and finally, it tries the full path that you passed to the -config option.

also, bestie, config files (so awstats.virtualhostname.conf or awstats.conf) must live in one of these three spots: /etc/awstats, /usr/local/etc/awstats, or /etc. that's the rule, periodt 📍

---

✨ OPTIONS ✨

a summary of the options is included below, and honestly? every single one of them matters 💖

• -update — to update statistics (this one's the default, she's the main character)
• -output — to output the main HTML report. heads up though: no update gets made, unless you also bring -update along for the ride
• -h — display usage information 🎀

---

🌈 ENVIRONMENT VARIABLES 🌈

AWStats peeks at the environment variable AWSTATS_FORCE_CONFIG 👀 — and if it's defined, AWStats will use it as the "config" value, whatever the value is on the command line. like, the env var just overrules you, respectfully 💀

---

🍓 SEE ALSO 🍓

want the more complete description of AWStats on the Debian system? look right here, bestie:

/usr/share/doc/awstats/

---

💜 AUTHOR 💜

AWStats was written by Laurent Destailleur <eldy@users.sourceforge.net> 🫶

This manual page was written by Sergey B Kirpichev <skirpichev@gmail.com>, for the Debian project (but may be used by others) ✨

---

okay that's the whole page, you ate that 🎀 no notes. this was the web server logfile analyzer page, AWSTATS(1) — and the version/date line at the bottom is part of the package's own manpage footer, so go peep the source if you want the exact build stamp. byeee, go analyze some logs, slay 💅👑