Webkernel Server Optimizer Suite

A comprehensive toolkit of bash scripts to optimize, monitor, and maintain PHP servers on Debian/Ubuntu with HestiaCP integration.

Overview

The Webkernel Server Optimizer suite consists of three complementary scripts designed to work together for complete server lifecycle management:

server-optimizer.sh — Initial setup and optimization
server-apps-autoheal.sh — Automated remediation and fixes
server-perf-report.sh — Performance diagnostics and reporting

Requirements

Debian 11/12 or Ubuntu 20.04+
Root access (all scripts require sudo)
Internet access (for Composer installation)
Optional: HestiaCP for advanced features

Script 1: server-optimizer.sh

Purpose: Initial server configuration and optimization (one-time setup)

Download & Run

Using `wget`

TIMESTAMP=$(date +%s)
wget "https://raw.githubusercontent.com/webkernelphp/server-optimizer/refs/heads/main/server-optimizer.sh?ts=$TIMESTAMP" -O server-optimizer.sh
sudo bash server-optimizer.sh [OPTIONS]

Using `curl`

TIMESTAMP=$(date +%s)
curl -L "https://raw.githubusercontent.com/webkernelphp/server-optimizer/refs/heads/main/server-optimizer.sh?ts=$TIMESTAMP" -o server-optimizer.sh
sudo bash server-optimizer.sh [OPTIONS]

Modes

Mode	Description
`--mode=numerimondes-webkernel`	Production preset (64G swap, all PHP versions, global Composer, OPcache, FPM, kernel tuning)

Options

Option	Description
`--swap=SIZE`	Swap file size (e.g., 4G, 16G, 64G)
`--session-tmpfs=SIZE`	RAM disk for PHP sessions (default: 512M)
`--php-versions=`	`all`, `8.1,8.2`, or `none`
`--composer=`	`global`, `users=user1,user2`, `skip`
`--no-opcache`	Disable OPcache tuning
`--no-fpm`	Disable PHP-FPM tuning
`--no-kernel`	Disable kernel tuning
`--log=PATH`	Custom log file
`--dry-run`	Show actions without applying changes
`--force`	Skip confirmation prompts
`-h, --help`	Show help

Examples

# Full production setup
sudo bash server-optimizer.sh --mode=numerimondes-webkernel

# Custom configuration
sudo bash server-optimizer.sh --swap=16G --php-versions=8.2,8.3 --composer=global

# Preview without changes
sudo bash server-optimizer.sh --dry-run --mode=numerimondes-webkernel

Features

Swap creation with safety checks
PHP version detection and tuning
OPcache configuration
PHP-FPM optimization
Kernel/sysctl tuning
Composer installation with signature verification
tmpfs for fast PHP sessions
Logging to configurable file
Dry-run mode for safe previews

Script 2: server-apps-autoheal.sh

Purpose: Automated application fixes and remediation (ongoing maintenance)

Download & Run

Using `wget`

TIMESTAMP=$(date +%s)
wget "https://raw.githubusercontent.com/webkernelphp/server-optimizer/refs/heads/main/server-apps-autoheal.sh?ts=$TIMESTAMP" -O server-apps-autoheal.sh
sudo bash server-apps-autoheal.sh [OPTIONS]

Using `curl`

TIMESTAMP=$(date +%s)
curl -L "https://raw.githubusercontent.com/webkernelphp/server-optimizer/refs/heads/main/server-apps-autoheal.sh?ts=$TIMESTAMP" -o server-apps-autoheal.sh
sudo bash server-apps-autoheal.sh [OPTIONS]

Options

Option	Description
`--dry-run`	Show what would be done without applying anything
`--yes`	Skip confirmation prompts for SAFE actions (dangerous always prompt)
`--only=SLUG`	Run only a specific fix by slug
`--list`	List all available fix slugs
`-h, --help`	Show help

Available Fix Slugs

Slug	Description	Safety
`fpm-dynamic`	Switch all ondemand pools to dynamic	SAFE
`fpm-dummy-children`	Raise dummy pool max_children from 4 to sane default	SAFE
`opcache-tune`	Set validate_timestamps=0, realpath_cache, memory	SAFE
`mysql-slowlog`	Enable MySQL slow query log	SAFE
`laravel-cache`	Run composer w-cache on all detected Webkernel projects	SAFE
`laravel-500`	Diagnose and repair Laravel 500 errors	SAFE
`env-debug-off`	Set APP_DEBUG=false on projects with debug on	DANGEROUS
`env-production`	Set APP_ENV=production on projects still in local/dev	DANGEROUS

Examples

# List all available fixes
sudo bash server-apps-autoheal.sh --list

# Preview changes without applying
sudo bash server-apps-autoheal.sh --dry-run

# Auto-apply all SAFE fixes
sudo bash server-apps-autoheal.sh --yes

# Run specific fix
sudo bash server-apps-autoheal.sh --only=opcache-tune

# Recommended order (interactive)
sudo bash server-apps-autoheal.sh --only=opcache-tune
sudo bash server-apps-autoheal.sh --only=fpm-dummy-children
sudo bash server-apps-autoheal.sh --only=fpm-dynamic
sudo bash server-apps-autoheal.sh --only=mysql-slowlog
sudo bash server-apps-autoheal.sh --only=env-debug-off
sudo bash server-apps-autoheal.sh --only=env-production
sudo bash server-apps-autoheal.sh --only=laravel-cache

Features

PHP-FPM pool optimization
OPcache tuning with verification
MySQL slow query log enablement
Laravel application config fixes
Per-project safety prompts
Automatic backups before changes
Service restart verification
Detailed logging to sysadmin reports
Dry-run mode for previews

Script 3: server-perf-report.sh

Purpose: Comprehensive performance diagnostics and analysis (diagnostic)

Download & Run

Using `wget`

TIMESTAMP=$(date +%s)
wget "https://raw.githubusercontent.com/webkernelphp/server-optimizer/refs/heads/main/server-perf-report.sh?ts=$TIMESTAMP" -O server-perf-report.sh
sudo bash server-perf-report.sh [OPTIONS]

Using `curl`

TIMESTAMP=$(date +%s)
curl -L "https://raw.githubusercontent.com/webkernelphp/server-optimizer/refs/heads/main/server-perf-report.sh?ts=$TIMESTAMP" -o server-perf-report.sh
sudo bash server-perf-report.sh [OPTIONS]

Options

Option	Description
`--test`	Run HTTP simulation against https://test.webkernelphp.com/
`--test="https://url"`	Run HTTP simulation against given URL
`--artisan`	Run Laravel cache warm-up on detected Webkernel projects
`--no-color`	Disable terminal colors
`-h, --help`	Show help

Examples

# Full report with system diagnostics
sudo bash server-perf-report.sh

# Report with HTTP performance testing
sudo bash server-perf-report.sh --test

# Test against specific domain
sudo bash server-perf-report.sh --test="https://example.com"

# Include Laravel cache warm-up
sudo bash server-perf-report.sh --artisan

# Full report with testing and cache warm-up
sudo bash server-perf-report.sh --test --artisan

# Non-color output (for logs)
sudo bash server-perf-report.sh --no-color > report.txt

Report Sections

The generated report includes:

Executive Summary — Critical issues with actionable fixes
System Overview — CPU, Memory, Disk, Process information
Network — Interface, sockets, connection states
HestiaCP — Panel configuration and status (if installed)
Nginx — Version, config, error logs, active connections
Apache2 — Configuration and status (if installed)
PHP-FPM — All versions, pool configs, OPcache status
MySQL/MariaDB — Configuration, performance variables, slow logs
Redis — Status, configuration, keyspace info
Supervisor — Queue worker status
Systemd Services — Status of relevant services
Cron Jobs — Scheduled tasks review
Webkernel/Laravel Projects — Project detection, .env review, logs
Artisan Cache Warm-up — Optional cache building
HTTP Simulation — Optional performance testing
OOM & Kernel Messages — Recent errors and warnings
System Limits — File descriptors, TCP settings, swap usage
Automated Checks — Performance issues with recommendations

Features

17 comprehensive diagnostic sections
Automatic issue detection (Critical/Warning/OK)
Actionable remediation recommendations
HestiaCP integration
Multi-PHP version support
Laravel project auto-discovery
OPcache health metrics
MySQL/MariaDB analysis
Redis/cache diagnostics
Network connection analysis
Kernel message review
Optional HTTP performance testing
Optional cache warm-up
Executive summary prepended to full report
Reports saved to /root/sysadmin/webkernel-reports/
Color-coded terminal output

Typical Workflow

Initial Setup

# 1. Optimize the server (one-time)
sudo bash server-optimizer.sh --mode=numerimondes-webkernel

# 2. Generate initial report
sudo bash server-perf-report.sh > initial-report.txt

Ongoing Maintenance (Monthly/As-Needed)

# 1. Apply all safe autoheal fixes
sudo bash server-apps-autoheal.sh --yes

# 2. Generate updated report
sudo bash server-perf-report.sh

# 3. Review summary for any remaining issues
# Issues shown in EXECUTIVE SUMMARY section

Troubleshooting Specific Issues

# When Laravel apps return 500 errors
sudo bash server-apps-autoheal.sh --only=laravel-500

# When OPcache memory is full
sudo bash server-apps-autoheal.sh --only=opcache-tune

# When response times are slow
sudo bash server-perf-report.sh --test="https://yoursite.com"

Common Scenarios

Slow Website Performance

# 1. Generate diagnostic report with HTTP testing
sudo bash server-perf-report.sh --test="https://yoursite.com"

# 2. Review EXECUTIVE SUMMARY for critical issues

# 3. Apply recommended fixes from autoheal
sudo bash server-apps-autoheal.sh --only=opcache-tune
sudo bash server-apps-autoheal.sh --only=fpm-dynamic

# 4. Verify with new report
sudo bash server-perf-report.sh --test="https://yoursite.com"

Laravel 500 Errors

# 1. Diagnose and repair
sudo bash server-apps-autoheal.sh --only=laravel-500

# 2. Check logs in generated report
sudo bash server-perf-report.sh

High CPU or Memory Usage

# 1. Generate diagnostic report
sudo bash server-perf-report.sh

# 2. Review "Top Processes by CPU/RAM" and "Automated Checks"

# 3. Apply relevant fixes
sudo bash server-apps-autoheal.sh --only=fpm-dynamic
sudo bash server-apps-autoheal.sh --only=env-debug-off

New Server Deployment

# 1. Initial optimization
sudo bash server-optimizer.sh --mode=numerimondes-webkernel

# 2. Apply all safe autoheal fixes
sudo bash server-apps-autoheal.sh --yes

# 3. Deploy applications, then generate report
sudo bash server-perf-report.sh --artisan

Log Locations

All scripts generate logs in /root/sysadmin/webkernel-reports/:

server-optimizer_TIMESTAMP.log — Setup logs
w-autoheal_TIMESTAMP.log — Autoheal fix logs
server-perf-report_TIMESTAMP.txt — Complete diagnostic report

License

EPL-2.0

For issues or suggestions

TO SEE EXISTING ONES, VISIT:

https://github.com/webkernelphp/server-optimizer/issues

TO CREATE A NEW ONE, VISIT:

https://github.com/webkernelphp/server-optimizer/issues/new (for a new one)

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

Webkernel Server Optimizer Suite

Overview

Requirements

Script 1: server-optimizer.sh

Download & Run

Using wget

Using curl

Modes

Options

Examples

Features

Script 2: server-apps-autoheal.sh

Download & Run

Using wget

Using curl

Options

Available Fix Slugs

Examples

Features

Script 3: server-perf-report.sh

Download & Run

Using wget

Using curl

Options

Examples

Report Sections

Features

Typical Workflow

Initial Setup

Ongoing Maintenance (Monthly/As-Needed)

Troubleshooting Specific Issues

Common Scenarios

Slow Website Performance

Laravel 500 Errors

High CPU or Memory Usage

New Server Deployment

Log Locations

License

For issues or suggestions

Using `wget`

Using `curl`

Using `wget`

Using `curl`

Using `wget`

Using `curl`