26 Commits

Author SHA1 Message Date
cschantz ce7879c964 Comprehensive README update with all new modules and features
MAJOR DOCUMENTATION UPDATE:

Directory Structure:
- Added complete security module listing (14 modules)
- Added email diagnostics category (9 modules)
- Added all backup/Acronis modules (18 total)
- Added maintenance modules (disk-space-analyzer)
- Added all 18 shared libraries with descriptions
- Added 6 utility tools (QA checker, signature updater, etc.)

New Features Documented:
- Bot Blocker: Apache User-Agent blocking manager
- Cloudflare Detector: Orange cloud vs gray cloud detection with locations
- Email Diagnostics: Complete 9-module email troubleshooting suite
- Live Attack Monitor v2: Updated from legacy version
- All Acronis Cyber Protect utilities

Enhanced Documentation:
- Complete module counts: 60+ modules across 6 categories
- Detailed feature descriptions for new tools
- Usage examples for bot blocker, cloudflare detector, email tools
- Updated version to 2.3.0
- Added statistics section (LOC, QA tests, etc.)

Libraries Documented:
- Attack detection: attack-patterns.sh, attack-signatures.sh, bot-signatures.sh
- Intelligence: threat-intelligence.sh, ip-reputation.sh, rate-anomaly-detector.sh
- Analysis: http-attack-analyzer.sh
- System: domain-discovery.sh, email-functions.sh, plesk-helpers.sh

Recent Updates:
- Week 4 (Jan 2026): Cloudflare detector + Bot blocker
- Week 3 (Jan 2026): Varnish cache + auto-mitigation
- Organized by feature release timeline

Before: Incomplete tree, missing 20+ modules
After: Complete documentation of all 60+ modules and 18 libraries
2026-01-28 16:01:47 -05:00
cschantz 849a112b5c Add Nginx + Varnish Cache Manager with complete cPanel integration
New Features:
- Full Varnish 6.6+ installation and configuration for cPanel servers
- 99.5% stock compliance using settings.json approach (RPM-safe)
- Complete HTTPS caching via SSL termination and config-script automation
- Two-tier revert system (partial/full stack removal)
- Enhanced status display with mode detection and color-coded port status
- Self-healing diagnostics with 8 automatic fixes
- Host header preservation fix for multi-domain WordPress compatibility

Technical Details:
- Supports ea-nginx + Varnish + Apache stack on AlmaLinux 9+
- Caches 93 static file types with smart bypasses for cPanel services
- Config-script ensures HTTPS traffic uses HTTP backend to Varnish
- Adaptive detection handles partial states and manual interventions

Co-Authored-By: Claude Sonnet 4.5 <noreply@anthropic.com>
2026-01-21 18:53:04 -05:00
cschantz e4611b994f Update README with new security features (v2.2)
Added comprehensive documentation for:
- Auto-Mitigation Engine (Score >= 80/100 blocking)
- Distributed attack detection and blocking (5+ IPs)
- Subnet-level blocking (25+ IPs from same /24)
- IPset kernel-level blocking with batching
- 24 attack signatures with improved accuracy
- Bot classification system
- Multi-source monitoring (HTTP, SSH, Email, FTP, DB, Network)
- No system pollution design (/tmp storage)

Updated version to 2.2.0 with January 2026 highlights.
Enhanced security module documentation in usage examples.
2026-01-08 17:24:19 -05:00
cschantz 6602bb6c0b Further condense README - remove excessive verbosity
Changes:
- System Diagnostics & Performance section: 19 lines → 7 lines
  - Removed detailed sub-bullets for Loadwatch and PHP Optimizer
  - Condensed to clean feature list
- Recent Updates section: 74 lines → 11 lines
  - Removed excessive checkmarks and detailed breakdowns
  - Condensed to key highlights and current feature count
- Directory structure: Removed duplicate diagnostics/ entry
- Fixed "Website Diagnostics & Troubleshooting" → "Website Diagnostics"

Before: 292 lines total
After: ~210 lines (28% reduction from previous version)

README is now concise and scannable without losing essential info.
2025-12-11 16:50:40 -05:00
cschantz f79753feb1 Reduce Acronis documentation verbosity in README
Changes:
- Condensed Backup & Recovery section from 14 lines to 5 lines
- Removed detailed Acronis sub-bullets (was overstated)
- Condensed directory structure: 15 Acronis script lines → 1 line
- Balanced coverage between Acronis and MySQL restore tool
- Kept essential info without excessive detail

Before: 14 bullet points for Acronis
After: 1 line for Acronis, cleaner overview
2025-12-11 16:48:59 -05:00
cschantz f669937117 Update README to reflect launcher cleanup and recent optimizations
Changes to README.md:

Updated Usage Examples:
- Replaced outdated multi-level menu paths with new streamlined structure
- Updated to match new 6-category main menu (1-6 numbering)
- Simplified navigation instructions
- Listed actual options available in each category

Updated Key Features:
- Security & Threat Analysis → Security & Monitoring
- Added "Optimized Status Checks" feature
- Listed all 14 actual security tools available
- Removed references to removed phantom features

Updated Recent Updates Section:
- Renamed to v2.1 (from v2.2)
- Added "December 2025 - Major Cleanup & Optimization" section
- Documented launcher streamline (90+ items removed, 64% code reduction)
- Documented performance optimizations (cached status checks)
- Documented MySQL restore tool features
- Listed actual implemented features by category:
  - Security & Monitoring: 14 tools
  - Website Diagnostics: 3 tools
  - Performance Analysis: 5 tools
  - Backup & Recovery: 11 tools
- Updated module counts to reflect reality (41 instead of 38)
- Removed references to unimplemented features

Key Improvements:
- README now accurately reflects what actually exists
- No more confusion about phantom features
- Clear tool counts for each category
- Updated navigation paths match new launcher
- Performance improvements documented
- All December 2025 updates included
2025-12-11 16:36:31 -05:00
cschantz fccb714cce Update documentation for MySQL restore tool and backup module
Main README.md:
- Added mysql-restore-to-sql.sh to directory structure
- Created dedicated Backup & Recovery section with subsections
- Documented MySQL restore tool features:
  - Multi-control panel support
  - Intelligent Force Recovery detection
  - Safe selective restore capabilities
  - Safety features (disk space, directory protection, warnings)
  - Clean SQL export functionality
- Added MySQL restore usage example
- Updated Recent Updates section with new tool features

modules/backup/README.md (NEW):
- Comprehensive documentation for backup module
- Acronis Cyber Protect integration section:
  - All 16 scripts documented with purposes
  - Usage examples and features
- MySQL/MariaDB Database Restore Tool section:
  - Key features and capabilities
  - Control panel path support details
  - Force Recovery levels explained
  - Smart detection for selective restore
  - Use cases and safety guarantees
  - Step-by-step wizard documentation
  - Technical details (second instance, file requirements)
  - Error detection and recovery procedures
- Integration with launcher documented
- Requirements and recent updates listed

Documentation Status:
- Main README updated with new tool
- Backup module README created from scratch
- All recent changes documented (InterWorx paths, smart detection, etc.)
- Ready for user testing
2025-12-10 23:07:11 -05:00
cschantz 24becbd06b Update README.md 2025-12-10 18:40:32 -05:00
cschantz 11a93b3c87 Update documentation with PHP optimizer and establish development log
DOCUMENTATION UPDATES:

README.md changes:
- Added php-optimizer.sh to performance modules section
- Added 3 new libraries: php-detector.sh, php-analyzer.sh, php-config-manager.sh
- Added comprehensive PHP Configuration Optimizer feature description
- Updated with all capabilities (7-day analysis, OPcache tuning, auto-backup, rollback)

DEVELOPMENT_LOG.md (NEW):
- Comprehensive tracking document for ALL development work
- Detailed documentation of PHP optimizer (Dec 2-3, 2025)
- Component breakdown: 4 files, 2,960 lines, 45 functions
- Complete workflow documentation for Option 4
- Safety features and testing status documented
- Git commit history tracked
- Development guidelines established
- Placeholder sections for Nov 21-30 work to be filled in

DEVELOPMENT GUIDELINES ESTABLISHED:
- NO AI attribution in commits (per user instructions)
- Update DEVELOPMENT_LOG.md with every change
- Track file statistics and testing status
- Document all git commits and decisions

This establishes proper ongoing documentation practices going forward.
2025-12-03 00:45:15 -05:00
cschantz 4bfade1bf3 Add Loadwatch Health Analyzer for system monitoring analysis
NEW FEATURE: Loadwatch Health Analyzer
- Comprehensive system health analysis from loadwatch monitoring logs
- Time-range analysis: 1h, 6h, 24h, 7d, 30d options
- Intelligent problem detection and trending

CAPABILITIES:
- Memory pressure detection (low available memory, high swap usage)
- CPU saturation analysis (idle %, iowait, steal time)
- Load average trending and threshold detection
- Process issue detection (zombie processes, high CPU/MEM consumers)
- MySQL performance monitoring (slow queries, thread counts)
- Network connection analysis
- Historical trending across snapshots (3-minute intervals)

IMPLEMENTATION:
- modules/diagnostics/loadwatch-analyzer.sh - Main analyzer script
- Handles symlinked loadwatch directories
- Parses 7 log sections: alerts, summary, memory, CPU, tasks, MySQL, network
- Generates detailed reports with actionable recommendations
- Saves reports to tmp/ directory for review

INTEGRATION:
- Added to Performance & Diagnostics menu (option 10)
- Time range selection submenu for user-friendly access
- Updated README.md with feature documentation and usage examples

ANALYSIS FEATURES:
- Swap threshold alerts (>= 50% usage)
- CPU saturation detection (< 10% idle)
- High I/O wait warnings (> 20%)
- Zombie process tracking
- Memory availability trending (avg/min/max)
- Top CPU consumers aggregated across period

Perfect for:
- Post-incident investigation
- Capacity planning
- Performance trending
- System health monitoring
- Identifying resource bottlenecks

Works with servers that have loadwatch monitoring enabled
(logs in /root/loadwatch or /var/log/loadwatch)
2025-11-20 20:35:16 -05:00
cschantz 4566b0e5da Update README to v2.2 with multi-panel support accomplishments
MAJOR UPDATE: v2.1 → v2.2

Added new section highlighting multi-panel architecture completion:
- Full cPanel, InterWorx, and Plesk support (all production ready)
- 38/38 modules refactored (100% complete)
- Automated validation scripts (13 tests InterWorx, 15 tests Plesk)
- All critical paths verified on production systems

New section on System Detection & Abstraction:
- Automatic control panel detection
- Multi-panel user/domain management abstraction
- Dynamic log discovery for all panel types
- Zero hardcoded paths - all detection-based

Updated existing sections to reflect multi-panel capabilities:
- Website Diagnostics now explicitly multi-panel
- Security tools updated with multi-panel support
- Core Infrastructure highlights production validation

Changed tagline to reflect multi-panel support capabilities.

This represents the completion of the largest refactoring effort
to date, bringing full multi-panel support to the entire toolkit.
2025-11-20 16:35:52 -05:00
cschantz 78ac3dddcd Update README with all-in-one command using source 2025-11-11 18:23:03 -05:00
cschantz fae334384e Add wrapper script for automatic cleanup with zero manual steps
New workflow:
1. User runs: source run.sh (instead of bash launcher.sh)
2. Launcher runs normally
3. On exit with cleanup=yes, launcher sets flag file
4. Wrapper detects flag and does ALL cleanup automatically:
   - Cleans ~/.bash_history file
   - Clears current shell's in-memory history
   - Removes toolkit directory
   - No manual commands needed

The key: wrapper is SOURCED so it runs in parent shell and can modify history.

User experience: answer "yes" and cleanup happens instantly, automatically.
2025-11-11 18:22:10 -05:00
cschantz db7bf8d594 Simplify to single command with cleanup after 2025-11-11 17:59:29 -05:00
cschantz 916db42e40 Add option to disable history before running curl command 2025-11-11 17:58:49 -05:00
cschantz e70628fa1c Update README with privacy cleanup instructions 2025-11-11 17:58:11 -05:00
cschantz 642a7dda7f Simplify README - just use trace eraser for privacy
Changes:
- Remove HISTFILE=/dev/null (doesn't actually work)
- Point users to built-in trace eraser tool
- Clean simple curl command

Reality: No bash trick reliably prevents history recording
Solution: Use the trace eraser after running toolkit
2025-11-11 17:41:24 -05:00
cschantz 2670c7c76d Use HISTFILE=/dev/null instead of leading space
Changes:
- Replace leading space with HISTFILE=/dev/null prefix
- More reliable - works on all systems
- Doesn't depend on HISTCONTROL settings

Command now prevents history recording universally
2025-11-11 17:39:16 -05:00
cschantz 1385d85726 Simplify README - remove comment from download command
Changes:
- Remove comment line inside code block
- Keep just the clean curl command
- Shorter tip below code block

Now easy to copy the command without extra lines
2025-11-11 17:37:43 -05:00
cschantz 50a9c25770 Add leading space to README download command
Changes:
- Add leading space before curl command in README
- Add privacy tip explaining HISTCONTROL=ignorespace
- Updated comment to indicate privacy feature

Command now includes space to prevent history recording:
 curl -sL https://git.mull.lol/.../tar.gz | tar xz && ...
2025-11-11 17:36:45 -05:00
cschantz 9cfa08f207 Update README to v2.1.0 with complete feature documentation
Directory Structure Updates:
- Added backup/ module (16 Acronis Cyber Protect scripts)
- Added website/ module (error analysis tools)
- Added maintenance/ module
- Updated security/ module with IP reputation manager

Key Features Additions:
- Complete Acronis backup management documentation
- Website diagnostics capabilities
- Enhanced security features section

Usage Examples:
- Added Acronis backup management examples
- Added website error analysis examples
- Updated all examples with current menu paths

Recent Updates:
- Bumped version to 2.1.0
- Reorganized updates into categories
- Documented all major features added since v2.0
2025-11-06 22:32:09 -05:00
cschantz 22637f22c9 Fix install command with correct lowercase directory name 2025-11-03 19:26:24 -05:00
cschantz 380f61ce7b Update README with all-in-one installation command
- Added single-line command to download and run
- Downloads from Gitea, extracts, and launches in one go
- Keeps original method as alternative for already installed
2025-11-03 19:19:02 -05:00
cschantz da22b79983 Merge remote README with local comprehensive version 2025-11-03 18:28:38 -05:00
cschantz a51d968185 Initial commit: Server Management Toolkit v2.0
- Complete security menu restructure (3-mode: Analysis/Actions/Live)
- Intelligent cPHulk enablement with CSF whitelist import
- Live network security monitoring dashboard
- Multi-source threat detection and classification
- 50+ organized security tools across 4-level menu hierarchy
- System health diagnostics with cPanel/WHM integration
- Reference database for cross-module intelligence sharing
2025-11-03 18:21:40 -05:00
cschantz 1a13e11978 Initial commit 2025-11-03 18:14:51 -05:00