OpenLiteSpeed

Key Features

• Event-driven architecture with asynchronous I/O handling up to 200,000+ concurrent connections
• Native LSCache engine with built-in object caching and ESI support for dynamic content acceleration
• Web-based administration console accessible on port 7080 for real-time server management
• Built-in PHP LSAPI for optimal PHP performance without requiring separate PHP-FPM processes
• Apache .htaccess compatibility allowing drop-in replacement without configuration changes
• Real-time statistics and monitoring with bandwidth throttling and connection limits
• Integrated ModSecurity WAF support for web application security protection
• HTTP/3 and QUIC protocol support for improved performance over unreliable networks

Common Use Cases

• 1High-traffic WordPress hosting requiring LSCache plugin integration for maximum performance
• 2Development environments for PHP applications needing Apache-compatible rewrite rules
• 3Small to medium business websites requiring reliable performance with minimal server resources
• 4Content delivery optimization for e-commerce sites with heavy dynamic content loads
• 5Migration from Apache servers while maintaining existing .htaccess configurations
• 6Educational environments teaching web server administration through graphical interfaces
• 7Staging servers for testing website performance under different server configurations

Prerequisites

• Docker Engine 20.10+ and Docker Compose V2 for container orchestration support
• Minimum 512MB RAM available for OpenLiteSpeed processes and caching operations
• Ports 80, 443, and 7080 available on the host system for HTTP, HTTPS, and admin access
• Basic understanding of web server concepts and virtual host configuration
• Knowledge of PHP application deployment if hosting dynamic websites
• SSL certificate files ready if enabling HTTPS for production websites

docker-compose.yml

1services: 
2  openlitespeed: 
3    image: litespeedtech/openlitespeed:latest
4    container_name: openlitespeed
5    restart: unless-stopped
6    environment: 
7      TZ: UTC
8    volumes: 
9      - ./html:/var/www/vhosts/localhost/html
10      - ols_data:/usr/local/lsws
11    ports: 
12      - "80:80"
13      - "443:443"
14      - "7080:7080"
15    networks: 
16      - ols-network
17
18volumes: 
19  ols_data: 
20
21networks: 
22  ols-network: 
23    driver: bridge

.env Template

1TZ=UTC

Usage Notes

Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  openlitespeed:
5    image: litespeedtech/openlitespeed:latest
6    container_name: openlitespeed
7    restart: unless-stopped
8    environment:
9      TZ: UTC
10    volumes:
11      - ./html:/var/www/vhosts/localhost/html
12      - ols_data:/usr/local/lsws
13    ports:
14      - "80:80"
15      - "443:443"
16      - "7080:7080"
17    networks:
18      - ols-network
19
20volumes:
21  ols_data:
22
23networks:
24  ols-network:
25    driver: bridge
26EOF
27
28# 2. Create the .env file
29cat > .env << 'EOF'
30TZ=UTC
31EOF
32
33# 3. Start the services
34docker compose up -d
35
36# 4. View logs
37docker compose logs -f

One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/openlitespeed/run | bash

Troubleshooting