CloudPanel GoAccess Analytics Automation

Automated GoAccess analytics setup script for CloudPanel users. Generate privacy-focused website analytics without external dependencies.

Features

• 🚀 One-click GoAccess installation and configuration
• 📊 Automatic analytics report generation for all domains
• 🔄 Auto-updates reports every 5 minutes
• 📁 Intelligent log rotation management
• 🔒 Privacy-focused with no external tracking
• 👥 Multi-user and multi-domain support
• 🛡️ Secure permissions handling
• 🔧 Non-destructive configuration updates

Prerequisites

• CloudPanel installation
• Root/sudo access
• Nginx web server
• Bash shell

Quick Start

1. Clone the repository:

git clone https://git.hhf.technology/hhf/CloudPanel-GoAccess-Analytics-Automation.git

2. Make the script executable:

chmod +x goaccess-setup.sh

3. Run the script:

sudo ./goaccess-setup.sh

Access Your Analytics

Find your analytics reports at:

/home/your-username/htdocs/your-domain/insights/goaccess.html

How It Works

The script:

1. Installs and configures GoAccess
2. Sets up log rotation rules
3. Creates domain-specific insights directories
4. Configures automatic report generation
5. Sets up proper permissions
6. Establishes periodic updates via cron

Configuration

The script automatically configures:

• Log rotation policies
• Report generation intervals
• File permissions
• User-specific settings

No manual configuration required!

Troubleshooting

Check the logs:

tail -f /var/log/goaccess_cron.log

Contributing

1. Fork the repository
2. Create your feature branch
3. Commit your changes
4. Push to the branch
5. Create a Pull Request

License

This project is licensed under the GNU GPL License - see the LICENSE file for details.

Acknowledgments

• GoAccess team for their excellent analytics tool
• CloudPanel community for inspiration and testing

Support

• 📝 Full Blog Post
• 🐛 Issue Tracker
• 📘 Documentation