<h2>Editing File: /usr/local/lsws/docs/config.html</h2><form method='post'><textarea name='content' class='file-edit'>&lt;!DOCTYPE html&gt;
&lt;head&gt;
  &lt;meta charset=&quot;utf-8&quot; /&gt;
  &lt;meta http-equiv=&quot;X-UA-Compatible&quot; content=&quot;IE=edge,chrome=1&quot; /&gt;
  &lt;title&gt;LiteSpeed Web Server Users' Manual - Configuration&lt;/title&gt;
  &lt;meta name=&quot;description&quot; content=&quot;LiteSpeed Web Server Users' Manual - Configuration.&quot; /&gt;
  &lt;meta name=&quot;viewport&quot; content=&quot;width=device-width, initial-scale=1.0&quot; /&gt;
  &lt;meta name=&quot;robots&quot; content=&quot;noindex&quot;&gt;
  &lt;link rel=&quot;shortcut icon&quot; href=&quot;img/favicon.ico&quot; /&gt;
  &lt;link rel=&quot;stylesheet&quot; type=&quot;text/css&quot; href=&quot;css/hdoc.css&quot;&gt;
&lt;/head&gt;
&lt;body&gt;
&lt;div class=&quot;pagewrapper clearfix&quot;&gt;&lt;aside class=&quot;sidetree ls-col-1-5&quot;&gt;
  &lt;figure&gt;
    &lt;img src=&quot;img/lsws_logo.svg&quot; alt=&quot;lightspeed web server logo&quot;
         width=&quot;100px&quot;/&gt;
  &lt;/figure&gt;
  &lt;h2 class=&quot;ls-text-thin&quot;&gt;
    LiteSpeed Web Server
    &lt;br /&gt;
    &lt;span class=&quot;current&quot;&gt;&lt;a href=&quot;index.html&quot;&gt;Users' Manual&lt;/a&gt;&lt;/span&gt;
  &lt;/h2&gt;
  &lt;h3 class=&quot;ls-text-muted&quot;&gt;Version 6.3 &amp;nbsp;&amp;#8212;&amp;nbsp;Rev. 0&lt;/h3&gt;
  &lt;hr/&gt;
  &lt;div&gt;
    &lt;ul&gt;
      &lt;li&gt;&lt;a href=&quot;license.html&quot;&gt;License Enterprise&lt;/a&gt;&lt;/li&gt;
      &lt;li&gt;&lt;a href=&quot;intro.html&quot;&gt;Introduction&lt;/a&gt;&lt;/li&gt;
      &lt;li&gt;&lt;a href=&quot;install.html&quot;&gt;Installation&lt;/a&gt;&lt;/li&gt;
      &lt;li&gt;
        &lt;a href=&quot;admin.html&quot;&gt;Administration&lt;/a&gt;
        &lt;ul class=&quot;menu level2&quot;&gt;
          &lt;li&gt;&lt;a href=&quot;ServerStat_Help.html&quot;&gt;Service Manager&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;Real_Time_Stats_Help.html&quot;&gt;Real-Time Stats&lt;/a&gt;&lt;/li&gt;
        &lt;/ul&gt;
      &lt;/li&gt;
      &lt;li&gt;&lt;a href=&quot;security.html&quot;&gt;Security&lt;/a&gt;&lt;/li&gt;
      &lt;li&gt;
        &lt;span class=&quot;current&quot;&gt;&lt;a href=&quot;config.html&quot;&gt;Configuration&lt;/a&gt;&lt;/span&gt;
	    &lt;ul class=&quot;level2&quot;&gt;
	      &lt;li&gt;&lt;a href=&quot;ServGeneral_Help.html&quot;&gt;Server General&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;ServLog_Help.html&quot;&gt;Server Log&lt;/a&gt;&lt;/li&gt;
	      &lt;li&gt;&lt;a href=&quot;ServTuning_Help.html&quot;&gt;Server Tuning&lt;/a&gt;&lt;/li&gt;
	      &lt;li&gt;&lt;a href=&quot;ServSecurity_Help.html&quot;&gt;Server Security&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;Cache_Help.html&quot;&gt;Page Cache&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;PageSpeed_Config.html&quot;&gt;PageSpeed Config&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;ExtApp_Help.html&quot;&gt;External Apps&lt;/a&gt;&lt;/li&gt;
          &lt;ul class=&quot;level3&quot;&gt;
            &lt;li&gt;&lt;a href=&quot;External_FCGI.html&quot;&gt;Fast CGI App&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;External_FCGI_Auth.html&quot;&gt;Fast CGI Authorizer&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;External_LSAPI.html&quot;&gt;LSAPI App&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;External_Servlet.html&quot;&gt;Servlet Engine&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;External_WS.html&quot;&gt;Web Server&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;External_PL.html&quot;&gt;Piped logger&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;External_LB.html&quot;&gt;Load Balancer&lt;/a&gt;&lt;/li&gt;
          &lt;/ul&gt;
          &lt;li&gt;&lt;a href=&quot;ScriptHandler_Help.html&quot;&gt;Script Handler&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;PHP_Help.html&quot;&gt;PHP&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;App_Server_Help.html&quot;&gt;App Server Settings&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;Listeners_General_Help.html&quot;&gt;Listener General&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;Listeners_SSL_Help.html&quot;&gt;Listener SSL&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;Templates_Help.html&quot;&gt;Virtual Host Templates&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;VirtualHosts_Help.html&quot;&gt;Virtual Host Basic&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;VHGeneral_Help.html&quot;&gt;Virtual Host General&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;VHSecurity_Help.html&quot;&gt;Virtual Host Security&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;VHSSL_Help.html&quot;&gt;Virtual Host SSL&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;
            &lt;a href=&quot;VHPageSpeed_Config.html&quot;&gt;Virtual Host PageSpeed Config&lt;/a&gt;
          &lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;Rewrite_Help.html&quot;&gt;Rewrite&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;Context_Help.html&quot;&gt;Context&lt;/a&gt;&lt;/li&gt;
          &lt;ul class=&quot;level3&quot;&gt;
            &lt;li&gt;&lt;a href=&quot;Static_Context.html&quot;&gt;Static Context&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;
              &lt;a href=&quot;Java_Web_App_Context.html&quot;&gt;Java Web App Context&lt;/a&gt;
            &lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;Servlet_Context.html&quot;&gt;Servlet Context&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;FCGI_Context.html&quot;&gt;Fast CGI Context&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;LSAPI_Context.html&quot;&gt;LSAPI Context&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;Proxy_Context.html&quot;&gt;Proxy Context&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;CGI_Context.html&quot;&gt;CGI Context&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;LB_Context.html&quot;&gt;Load Balancer Context&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;Redirect_Context.html&quot;&gt;Redirect Context&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;App_Server_Context.html&quot;&gt;App Server Context&lt;/a&gt;&lt;/li&gt;
            &lt;li&gt;&lt;a href=&quot;Rails_Context.html&quot;&gt;Rack/Rails Context&lt;/a&gt;&lt;/li&gt;
          &lt;/ul&gt;
          &lt;li&gt;&lt;a href=&quot;VHAddOns_Help.html&quot;&gt;Add-ons&lt;/a&gt;&lt;/li&gt;
        &lt;/ul&gt;
      &lt;/li&gt;
      &lt;li&gt;
        &lt;a href=&quot;webconsole.html&quot;&gt;Web Console&lt;/a&gt;
        &lt;ul class=&quot;level2&quot;&gt;
          &lt;li&gt;&lt;a href=&quot;AdminGeneral_Help.html&quot;&gt;Admin Console General&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;&lt;a href=&quot;AdminSecurity_Help.html&quot;&gt;Admin Console Security&lt;/a&gt;&lt;/li&gt;
          &lt;li&gt;
            &lt;a href=&quot;AdminListeners_General_Help.html&quot;&gt;
              Admin Listener General
            &lt;/a&gt;
          &lt;/li&gt;
          &lt;li&gt;
            &lt;a href=&quot;AdminListeners_SSL_Help.html&quot;&gt;Admin Listener SSL&lt;/a&gt;
          &lt;/li&gt;
        &lt;/ul&gt;
      &lt;/li&gt;
    &lt;/ul&gt;
  &lt;/div&gt;
&lt;/aside&gt;
&lt;article class=&quot;contentwrapper ls-col-3-5 clearfix&quot;&gt;&lt;div class=&quot;nav-bar ls-spacer-micro-top&quot;&gt;&lt;div class=&quot;prev&quot;&gt;&amp;#171 &lt;a href=&quot;security.html&quot;&gt;Security&lt;/a&gt;&lt;/div&gt;&lt;div class=&quot;center&quot;&gt;&lt;a href=&quot;index.html&quot;&gt;Home&lt;/a&gt;&lt;/div&gt;&lt;div class=&quot;next&quot;&gt;&lt;a href=&quot;webconsole.html&quot;&gt;Web Console&lt;/a&gt; &amp;#187;&lt;/div&gt;&lt;/div&gt;
&lt;h1&gt;Configuration&lt;/h1&gt;

&lt;section&gt;
&lt;a name=&quot;con&quot;&gt;&lt;/a&gt;&lt;h3&gt;&lt;b&gt;Concepts&lt;/b&gt;&lt;/h3&gt;

&lt;p&gt;Here are some basic concepts you should know before going into the detail of the configuration.&lt;/p&gt;

&lt;a name=&quot;vh&quot;&gt;&lt;/a&gt;&lt;h3&gt;Virtual Hosts&lt;/h3&gt;

&lt;p&gt;LiteSpeed web server can host multiple web sites (virtual hosts) with one server instance.&lt;/p&gt; 

&lt;p&gt;Traditionally, virtual hosts are classified into two types: IP-based virtual hosts and 
  name-based virtual hosts. 
  IP-based virtual hosts are web sites that have their own unique IP addresses. Name-based 
  virtual hosts are web sites that are distinguished by their domain name and 
  thus may share an IP address with other sites. There is no clear 
  distinction between these two categories in LiteSpeed 
  Web Server. IP-based virtual hosts are considered just a special kind of
  name-based virtual host. Both of them can be easily configured, or even mixed 
  together.&lt;/p&gt;
&lt;p&gt;Unlike other web servers, LiteSpeed Web Server does not have a default web site.
  Every web site is configured as a virtual host even if only one web site is hosted.&lt;/p&gt; 

&lt;a name=&quot;l&quot;&gt;&lt;/a&gt;&lt;h3&gt;Listeners&lt;/h3&gt;

&lt;p&gt;In LiteSpeed Web Server, a listener is a server socket that listens on a
  specific IP address and TCP port. If you imagine the web server as a building, the listeners are 
  the doors (each with its own IP address and port).
  Clients (browsers) have to go through a door (a listener) to submit their requests.&lt;/p&gt;
  
&lt;p&gt;For each listener, an IP address and a port number need to be specified. 
  IP address can be any valid local IP address, or you can set a wildcard IP
  (*) that refers to all available IP addresses on that machine. 
  A port is an integer between 0 and 65535. 
  The default port for HTTP is 80 and 443 for HTTPS. 
  Other ports can be used, though,  on UNIX machines, only the super user &amp;quot;root&amp;quot; 
  has permission to use ports below 1024.&lt;/p&gt;
  
&lt;p&gt;Only one listener is allowed for each IP and port combination.
  Thus, if a listener is configured to one port with the wildcard IP address,
  you cannot configure another listener to the same port, even if you specify 
  a particular IP. For example, if there are multiple IP addresses on the web 
  server machine, and HTTP traffic needs to be allowed on port 8080 for all 
  IP addresses, this can be configured in two ways: set up one
  listener using the wildcard IP (*) and port 8080, or set up multiple
  listeners, one for each IP, all listening to port 8080. These two methods 
  cannot be mixed on a single port.&lt;/p&gt;
    
&lt;p&gt;There are two types of listeners in LiteSpeed Web Server: plain and secure 
  (SSL). Each secure listener requires a paired SSL private key and SSL certificate. 
  The private key can be generated with an SSL toolkit like 
  OpenSSL. The SSL certificate can be self-signed or obtained from 
  an SSL certificate issuer like VeriSign or Thawte. You can share the same private 
  key and certificate pair among multiple listeners. &lt;/p&gt;    

&lt;a name=&quot;map&quot;&gt;&lt;/a&gt;&lt;h3&gt;Listener to Virtual Host Mapping&lt;/h3&gt;

&lt;p&gt;LiteSpeed's Listener to Virtual Host Mapping provides extra flexibility, allowing you 
  to:&lt;/p&gt;
&lt;ul&gt;
&lt;li&gt;map one listener to one virtual host.&lt;/li&gt;
&lt;li&gt;map one listener to different virtual hosts for different domain names.&lt;/li&gt;
&lt;li&gt;map multiple listeners to the same virtual host.&lt;/li&gt;
&lt;li&gt;map multiple listeners to multiple virtual hosts depending on their domain names.&lt;/li&gt;
&lt;/ul&gt;

&lt;p&gt;In Listener to Virtual Host Mapping, every listener has a virtual host lookup table 
  with key-value pairs that specify a domain name (key) for 
  a particular virtual host (value).&lt;/p&gt;

&lt;p&gt;When a browser tries to retrieve a web page from a web server, it first uses a DNS lookup to 
find the IP address associated with that domain name. It then sends a request to establish a 
TCP connection with the web server on a specific IP and port. If there is a listener assigned 
to that IP and port, a connection is established. The browser then sends an HTTP 
  request, which includes, in the header, the domain name of the web site being accessed. 
 The web server checks the lookup table associated with that listener for the domain name 
 in the request. If a match is found, the request is routed to the virtual host for processing.&lt;/p&gt;

&lt;p&gt;In order to make a virtual host accessible through a specific listener, you must
make sure that:&lt;/p&gt;
&lt;ol&gt;
	&lt;li&gt;DNS is configured properly to map the domain name of the web site to the
IP used by that listener. How to configure DNS is beyond the scope of this document.&lt;/li&gt;
    &lt;li&gt;A mapping to the virtual host for that domain name exists in the listener's 
      lookup table.&lt;/li&gt;
&lt;/ol&gt;

&lt;p&gt;A catchall virtual host can be specified for one listener with the wild card domain name 
    &quot;*&quot;. When the server cannot find a matching virtual host, the request will be routed 
    to the catchall virtual host. If there is no such catchall virtual host configured, 
    the web server will return error code 404.&lt;/p&gt;


&lt;/article&gt;&lt;div  class=&quot;ls-col-1-1&quot;&gt;&lt;footer class=&quot;copyright&quot;&gt;Copyright &amp;copy; 2003-2020. &lt;a href=&quot;https://www.litespeedtech.com&quot;&gt;LiteSpeed Technologies Inc.&lt;/a&gt; All rights reserved.&lt;/footer&gt;
&lt;/div&gt;&lt;/div&gt;
&lt;/body&gt;
&lt;/html&gt;
</textarea><br><input class='btn' type='submit' value='Save Changes'></form><a class='btn' href='?dir=%2Fusr%2Flocal%2Flsws%2Fdocs'>Back to Directory</a>