1-Click Web Server Switcher & Domain Configuration

📌 Purpose & Quick Summary

BoostonCP is built on an industry-leading Domain Webserver Switcher architecture. Within the Domain Management Studio, you can switch any domain's backend web server between Host Nginx (PHP-FPM), Apache 2.4 (Port 8080), and OpenLiteSpeed (Port 8081) in under 1 second with zero downtime. This grants you complete flexibility to leverage Apache .htaccess rewrites, LiteSpeed caching engines, or raw Nginx performance whenever required.

🖥️ Interface Tour & Elements

When you click Manage on any domain in the ledger, the Domain Studio modal opens with modular management tabs:

1. Aliases & Subdomains Tab: Configure parked domains, subdomains, and wildcard SaaS routing (*.yourdomain.com).
2. Web Server Switch Tab: 1-click switcher between Host Nginx, Apache 8080 Docker container, and OpenLiteSpeed 8081 Docker container.
3. Directory Tab: Re-target the document root directory or switch between /public and root folders.
4. Vhost Monaco Studio: Inspect and customize VirtualHost configuration directives directly in Monaco IDE.
5. PHP Engine Switch: Change PHP versions on the fly and toggle FastCGI buffering.
6. Performance & Caching: Enable OpCache, Redis object caching, or FastCGI microcaching.
7. Framework Optimization: 1-click presets for Laravel (/public directory rewrites), WordPress, and Next.js.
8. SSL Management: Issue or renew Let's Encrypt certificates and enforce HTTPS.
9. URL Redirects: Configure fast domain forwarding and wildcard paths.
10. Security & DDoS Protection: Toggle Under Attack Mode and configure per-domain visitor limits.

🛠️ Step-by-Step Instructions

Step 1: Switching the Web Server Engine

1. Navigate to Domains and click Manage next to the target domain.
2. Select the Web Server tab inside the studio modal.
3. You will see three cards representing the available engines:
   • Host Nginx: Ultra-low memory footprint, high-concurrency static delivery, direct PHP-FPM socket.
   • Apache (Port 8080): Full native .htaccess support, mod_rewrite compatibility.
   • OpenLiteSpeed (Port 8081): High-speed event-driven architecture, native LSCache engine compatibility.
4. Click the Activate button on your preferred engine.
5. The backend compiler instantaneously updates the Nginx edge proxy reverse configuration and reloads listeners in ~1 second.

Step 2: Configuring Framework Optimization (e.g. Laravel)

1. Within the Domain Studio modal, click the Framework & Subdirectory Optimization tab.
2. Select Laravel from the framework presets list.
3. The document root automatically adjusts to append /public, and standard Nginx URL rewrite rules (try_files $uri $uri/ /index.php?$query_string;) are applied.
4. Click Apply Framework Configuration.

Step 3: Enabling Under Attack Mode

1. Click the Security & DDoS Protection tab.
2. Locate the Under Attack Mode toggle switch and turn it ON.
3. Set your desired Visitor Rate Limit (e.g. max 60 requests per minute per IP).
4. Click Save Security Rules. Suspicious rapid requests are now automatically rate-limited at the edge.

⚙️ Complete Field & Parameter Reference Table

❓ Troubleshooting & Common Errors

1. .htaccess Rules Ignored on Host Nginx

• Cause: Nginx does not natively parse Apache .htaccess files.
• Solution: Either switch the domain to Apache 8080 or OpenLiteSpeed 8081 using the Web Server Switcher, or translate your .htaccess rewrite rules into Nginx syntax inside the Vhost Monaco Studio tab.

2. Switching Webserver Returns "Port Conflict / Service Unavailable"

• Cause: Docker container for Apache (8080) or OLS (8081) was not started by the server administrator.
• Solution: Switch the domain back to Host Nginx for instant 100% uptime, and contact your server administrator to verify Docker container health on Ports 8080 and 8081.