This is an old revision of the document!
Configuration How-Tos
This section of the wiki provides articles on configuring LiteSpeed Web Server to achieve desired functionality, better performance, or security. These wikis do not cover what each LSWS setting does. That information can be found in our documentation.
Also LiteSpeed Cache, LiteMage Cache, PHP, and other external applications (Python, Ruby, etc.) are covered in their own sections of the wiki and are not included here.
| Command Reference | Quick Reference for All Commands |
| LSWS Config | LSWS Configuration Items |
Performance tips
| My site running slow, how to make it faster? | How to improve my site performance? |
| My server load is high, how to resolve it? | How to resolve my server load issue? |
| Controlling PHP Concurrency | How to control how many connections your PHP engine can serve at once |
| Understand LSWS "PHP suEXEC Max Conn" and Cloudlinux LVE | LSWS “PHP suEXEC Max Conn” should be always less than CL LVE EP |
QUIC
| Enable QUIC | How to Enable QUIC at the Server Level |
| Disable QUIC | How to Disable/Enable QUIC at the VHost and Listener Levels |
| Quic makes quicker | How QUIC makes the web quicker |
| Supported Quic Versions | What Quic versions does LSWS support? |
PageSpeed
| Enable PageSpeed | How to enable PageSpeed module |
| Compare PageSpeed and lscache | Should I turn on both PageSpeed and lscache? |
Proxy
| Proxy as a Context | How to setup LiteSpeed Web Server as a Proxy via Contexts |
| Proxy as a RewriteRule | How to setup LiteSpeed Web Server as a Proxy via Rewrite Rules |
GeoLocation
| GeoLocation | How to enable IP to GeoLocation |
IP2Location
| ip2location | How to enable IP2Location |
Header Settings
| CORS | How to enable CORS on LSWS |
| Server Push | How to use Server Push on LSWS |
Security
| Security Overview | LiteSpeed web server security overview |
| Mitigating SYN Floods | How to harden your kernel against SYN floods |
| Shared Hosting Security | Access Permission isolation |
| suEXEC Mode | Process UID isolation: CGI/FCGI/LSAPI/PHP |
| chroot | Process Execution isolation |
| mod_security Compatibility | Apache mod_security 2.5+ compatibility |
| Atomicorp setup and support | Explanation of Atomicorp's support of LSWS and how to set it up |
| CloudLinux CageFS How-To | Installation and Configurations |
| Setting up HSTS | How to set up HTTP Strict Transport Security |
| Virtual Host-Level Bandwidth Throttling | Set different bandwidth limits for different sites |
| Void CloudFlare IP/Subnet blocking | How to avoid LSWS Anti-ddos blocking CloudFlare IP/subnet connections |
| How to disable CGI script | Disable all CGI scripts |
| WordPress Protection | How WordPress Brute Force Protection works |
| Realm and .htaccess | How to setup authentication |
How to mitigate DDoS attacks with LSWS's built-in security features
| Mitigating HTTP-level DDoS Attacks | How to mitigate DDoS attacks with LSWS's security features |
| Understanding LiteSpeed Advanced Anti-DDos Setup Service | Fine tune anti-DDoS configurations and set up a script using iptables to automatically block attacking IPs detected by web server. |
HTTPS/SSL Configuration
| Create an SSL private key | How to create a SSL private key |
| Self Signed SSL Certificate | How to create a self signed SSL certificate |
| Create a certificate request | How to create a SSL certificate request for applying a trusted SSL certificate from CA issuer. |
| Install a SSL certificate | How to install a SSL certificate |
| Secure web admin console | How to secure web administration console with SSL |
| Redirect to https connection | How to redirect from plain http connection to secured https connection |
| OCSP Stapling | How to set up OCSP stapling for faster SSL |
| Disabling HTTP/2 | Disabling HTTP/2 per virtual host |
Logs/Monitoring
| Syslog/Splunk Logger | High performance logging of litespeed logs to syslog/splunk via udp. |
| SNMP Monitoring + Cacti Graphing | Monitor LiteSpeed real-time metrics via SNMP client and full-Cacti log/graph integration |
| Server Status + RRD Graphing | Monitor LiteSpeed Server Status via RRD Graph |
| Piped Logger | Flexible logging with piped logger |
| AWstats | How to use integrated AWstats log analyzer |
| New Relic Installation Guide | How to get New Relic to work with LSWS |
| Real-Time Statistics | Real-Time Statistics in Admin Console |
| Child process killed, is that normal? | How to deal with “Child Process Killed” message in stderr.log |
Debugging
| Bug Reporting | How to file a LiteSpeed bug report |
| Toggle Debug Logging | A feature for quickly switching between normal and very detailed log levels |
| How to Enable Rewrite Logging | The first step in debugging rewrite rules |
| How to Debug my Rewrite Rule | The steps to check the failed rewrite rule |
Streaming Media
| FLV streaming | Flash Video (FLV) Streaming (random seek) |
| MP4 streaming | MP4/H264/F4V Video Streaming |
Tuning
| Disable Brotli Per Account/Domain | How to disable Brotli on a per Account/Domain basis |
| Disable Brotli Per Server Wide | How to disable Brotli Server Wide |
| gzip Compression | How can I use gzip compression to save bandwidth? |
| Linux OS Tuning | How to tune Linux OS for maximum performance for LiteSpeed. |
| File Descriptor Limit | How to increase the file descriptor limit |
| Internal Redirect | For those seeking x-sendfile or x-accel-redirect feature. We show you how with LiteSpeed. |
| nf_conntrack table | “nf_conntrack: table full, dropping packet.” issue |
| Virtual Host-Level Bandwidth Throttling | Set different bandwidth limits for different sites |
| Understanding RAM Disk Path Setting | Will RAM disk setting help with I/O load issue |
| Understanding keep alive setting | How to set “keep alive” for my site |
Miscellaneous Customization
| Auto Index Customization | How to customize auto index script |
| Microsoft FrontPage Server Extensions 2002 | How to install Microsoft FrontPage Server Extensions 2002 |
| MultiViews | How to handle MultiViews |
| Enable HTTP2 | How to enable HTTP2 |
| Disable TLS1.0 | How to disable TLS1.0 while enable TLS1.2 and TLS1.3 |
| Add MIME type | How to add MIME type if not exist |
| Show real IP behind a proxy | How to restore real visitor IP instead of proxy? |
| Special Rewrite Rule Directives | Using special directives in rewrite rules |
| Why my redirect from /cgi-bin/script working with apache but 404 on LSWS? | How to fix the 404 error when redirecting /cgi-bin/script? |
Virtual Hosting
| Name-Based Virtual Hosting | How to set up name-based virtual hosting |
| IP-Based Virtual Hosting | How to set up IP-based virtual hosting |
Troubleshooting errors
| Understanding 500 error | What is 500 internal server error and how to fix it? |
| Understanding 404 error | What is 404 Not Found error and how to fix it? |
Setup LSWS as load balancer
| Setup LSWS as load balancer | How to setup LSWS as load balancer? |
Custom Templates
Custom templates can be used to make LSWS virtual hosts that have been prepared for popular web applications and plugins. All templates use LiteSpeed native configurations. They are unnecessary if you are migrating an existing site with web applications from Apache.
| Virtual Host Templates | How to use a template to configure a group of virtual hosts with similar configurations |
| WP Super Cache | Template and tutorial for quick and easy set up of LSWS with WordPress and WP Super Cache |
| W3 Total Cache | How to use a template to set up LSWS with WordPress and W3 Total Cache |
| Reverse Proxy | Use a template to set up LSWS as a reverse proxy in under seven minutes |
| MediaWiki | Setting up MediaWiki with LSWS is faster and easier with a template |
| phpBB | Set up this popular open source bulletin board application with a template |
| phpList | A tutorial and template for setting up phpList with LSWS |