QuickPress

One-command ClassicPress installer for Alpine Linux VMs with performance optimizations and SSL support.

Overview

QuickPress is an end-to-end automated installer that sets up a production-ready ClassicPress (WordPress-compatible CMS) instance. It configures a high-performance LEMP-like stack optimized for VMs and small servers.

What's Installed

Component	Purpose	Optimization
Lighttpd	Web server	Event-driven, low memory footprint
PHP 8.3	Application runtime	OPcache + JIT compilation
MySQL/MariaDB	Database	Tuned InnoDB buffer pool
KeyDB/Redis	Object cache	In-memory data structure store
ClassicPress 2.6.0	CMS	Pre-configured for performance

Platform Differences

Feature	Alpine Linux	FreeBSD
Package Manager	apk	pkg
Init System	OpenRC	rc.d
Database	MariaDB	MySQL 8.2 (MariaDB fallback)
Object Cache	KeyDB	Redis
Web User	lighttpd	www

Features

• ⚡ Performance Tuned: OPcache + JIT, query caching, static file caching, Gzip compression
• 🔒 SSL Ready: Let's Encrypt auto-renewal or self-signed certificates for IP addresses
• 🚀 One Command: Single script installation, no manual configuration needed
• 📦 Optimized Stack: Minimal resource usage suitable for small VMs (1GB+ RAM)
• 🔄 Auto-Maintenance: Cron jobs for SSL renewal, WP-Cron replacement, permission fixes
• 🖼️ Upload Ready: Proper permissions and PHP extensions for image/media uploads

Requirements

Alpine Linux

• Alpine Linux (3.16+)
• Root access
• 1GB+ RAM recommended

FreeBSD

• FreeBSD 13.x or 14.x
• Root access
• 1GB+ RAM recommended
• MySQL 8.2 (default) or MariaDB 10.6 (fallback)
• (Optional) Domain pointed to server for Let's Encrypt SSL

Quick Start

Alpine Linux

wget https://raw.githubusercontent.com/yourusername/quickpress/main/quickpress.sh
chmod +x quickpress.sh
sudo ./quickpress.sh

FreeBSD

fetch https://raw.githubusercontent.com/yourusername/quickpress/main/quickpress-freebsd.sh
chmod +x quickpress-freebsd.sh
sudo ./quickpress-freebsd.sh

Then open http://YOUR_SERVER_IP/wp-admin/install.php to complete ClassicPress setup.

Usage

No SSL (HTTP only)

./quickpress.sh

Alpine Linux

# Let's Encrypt SSL (requires domain)
./quickpress.sh --ssl-domain example.com --ssl-email admin@example.com

# Self-Signed SSL (works with IP addresses)
./quickpress.sh --ssl-self-signed

# Show Help
./quickpress.sh --help

FreeBSD

# Let's Encrypt SSL (requires domain)
./quickpress-freebsd.sh --ssl-domain example.com --ssl-email admin@example.com

# Self-Signed SSL (works with IP addresses)
./quickpress-freebsd.sh --ssl-self-signed

# Show Help
./quickpress-freebsd.sh --help

Performance Optimizations

PHP 8.3

• OPcache: 256MB memory, 10K accelerated files
• JIT Compiler: 128MB buffer, tracing mode
• Upload limits: 64MB file size, 300s execution time
• Unix socket: Faster than TCP for PHP-FPM

KeyDB (Redis-compatible)

• Multi-threaded (4 threads) for high concurrency
• Memory-optimized cache with LRU eviction
• Auto-configured for ClassicPress object caching

MariaDB

• InnoDB buffer pool (50% of system RAM)
• Query cache enabled (64MB)
• Optimized connection and thread settings

Lighttpd

• Event-driven architecture (linux-sysepoll)
• Gzip compression for text assets
• Static file caching (1 month for images)
• ETags for cache validation

ClassicPress Configuration

• Post revisions limited to 3
• Autosave interval: 120s (reduces DB writes)
• WP-Cron disabled (replaced with system cron)
• Direct filesystem (no FTP required)

Post-Installation

Enable Object Cache (Recommended)

1. Go to wp-admin -> Plugins -> Add New
2. Search: "Redis Object Cache" by Till Kruss
3. Install and Activate
4. Go to Settings -> Redis -> Enable Object Cache

The plugin auto-connects to KeyDB at 127.0.0.1:6379.

Service Management

Alpine Linux:

# Restart services
service lighttpd restart
service php-fpm83 restart
service mariadb restart
service keydb restart

# Check status
keydb-cli ping           # KeyDB
php -i | grep opcache    # OPcache

FreeBSD:

# Restart services
service lighttpd restart
service php-fpm restart
service mysql-server restart
service redis restart

# Check status
redis-cli ping           # Redis
php -i | grep opcache    # OPcache

Troubleshooting Uploads

If file uploads fail:

# Fix permissions
fix-classicpress-permissions

# Check logs
tail -f /var/log/lighttpd/error.log

Alpine Linux:

tail -f /var/log/php83/error.log
php83 -m | grep -E 'gd|exif|imagick'

FreeBSD:

tail -f /var/log/php-fpm.log
php -m | grep -E 'gd|exif|imagick'

SSL Certificate Management

Let's Encrypt:

# Manual renewal
~/.acme.sh/acme.sh --cron --home ~/.acme.sh

# View renewal logs
cat /var/log/acme-renewal.log

Self-Signed (FreeBSD only):

# Regenerate certificate
cd /usr/local/etc/ssl/acme
openssl req -x509 -nodes -days 365 -newkey rsa:2048 \
  -keyout self-signed-new.key -out self-signed-new.pem \
  -subj "/CN=YOUR_SERVER_IP"

Alpine Linux

Component	Path
Web Root	/var/www/classicpress
wp-config.php	/var/www/classicpress/wp-config.php
Credentials	/root/classicpress-login.txt
Lighttpd Config	/etc/lighttpd/lighttpd.conf
PHP Config	/etc/php83/conf.d/00_opcache.ini
MariaDB Config	/etc/my.cnf.d/mariadb-server.cnf
KeyDB Config	/etc/keydb.conf
SSL Certificates	/etc/ssl/acme/
Log File	/var/log/classicpress-install.log

FreeBSD

Component	Path
Web Root	/usr/local/www/classicpress
wp-config.php	/usr/local/www/classicpress/wp-config.php
Credentials	/root/classicpress-login.txt
Lighttpd Config	/usr/local/etc/lighttpd/lighttpd.conf
PHP Config	/usr/local/etc/php/
MySQL Config	/usr/local/etc/mysql/my.cnf
Redis Config	/usr/local/etc/redis.conf
SSL Certificates	/usr/local/etc/ssl/acme/
Log File	/var/log/classicpress-install.log

Architecture

graph LR
    A[Client Browser] -->|HTTP/HTTPS| B[Lighttpd 80/443]
    B -->|FastCGI| C[PHP-FPM 8.3]
    C --> D[(MariaDB 3306)]
    C --> E[(KeyDB 6379)]
    C --> F[Filesystem]

Loading

Security Features

• File editing disabled in admin (DISALLOW_FILE_EDIT)
• Dangerous PHP functions disabled
• Proper file permissions on wp-config.php
• Hidden files denied access
• Security headers enabled (X-Frame-Options, X-Content-Type-Options, etc.)

License

This project is released into the public domain via the Unlicense.

Repository Structure

.
├── LICENSE                   # Unlicense (public domain)
├── README.md                 # This file
├── quickpress.sh             # Alpine Linux installer
└── quickpress-freebsd.sh     # FreeBSD installer

Credits

• ClassicPress - The CMS
• KeyDB - Multi-threaded Redis fork (Alpine)
• Redis - In-memory data store (FreeBSD)
• Alpine Linux - Lightweight Linux distribution
• FreeBSD - Advanced Unix-like operating system