Install:Command Line

From OpenLiteSpeed Wiki

Revision as of 19:14, 7 October 2014 by Marmstrong (talk | contribs) (Installation)

Minimum system requirements

  • Operating System:
Linux(i386): kernel 2.4 and up, glibc-2.2 and up
CentOS: 5 and up
Ubuntu: 8.04 and up
Debian: 4 and up
Solaris(x86): SunOS 5.8 and up
FreeBSD(i386): 4.5 and up
MacOSX: 10.3 and up
  • CPU:
Intel: 80486 and up
PowerPC: PowerPC G4
  • Memory: 32MB and up
  • Disk:
Installation: 200MB
Runtime: 300MB and up, swapping space depends on usage.


The quick and easy way to install OpenLiteSpeed is through our OpenLiteSpeed repository. OpenLiteSpeed Installation can also be performed in a command line terminal as detailed below.

For testing purposes, OpenLiteSpeed can be installed into a home directory by a non-privileged user. For production use, it should be installed into a system directory which requires root access or using sudo).


OpenLiteSpeed requires pcre, expat, openssl, geoip, and zlib to be installed before you run the configure command. Our dependencies article gives steps for installing these packages in a number of different OSs.

Installation Steps

  • Download the package into a convenient location and decompress it.
  • Go to the installation directory, compile, and install the package as the root user (for production use):
cd openlitespeed-1.x.x
make && make install

Note: A number of options and settings can be configured pre-installation. Use ./configure --help to see the configurable options.

  • By default, the Installer will install a sample site on port 8088 and set the WebAdmin console (the LiteSpeed GUI) to port 7080. (user: admin password: 123456)


If you run into errors or problems during installation, please consult our errors article for common problems.

Getting Started

  • The default installation directory is /usr/local/lsws.
  • For detailed information on controlling the server processes, please see the Administration Guide.
To start the server, simply run /usr/local/lsws/bin/lswsctrl start. (To stop it, run /usr/local/lsws/bin/lswsctrl stop.)
  • A sample site should be running on the server.
To access your site, point your browser to http://[address]:8088/, [address] being the IP address or domain name of your web server machine. Use "localhost" if the server is on the machine you are using. By default, OpenLiteSpeed runs on port "8088".
A congratulations page linked to other testing pages should load into the browser when pointed to the above address. If not, try testing the WebAdmin interface.
  • The default port for the WebAdmin console is 7080.
Plug https://[address]:7080/, into your browser to go to the WebAdmin interface.
Remember the "https://" and that for [address] you can use "localhost" if you're currently using the machine the server is on.
A login page should load. The defaults for the administrator's user name and password are "admin" and "123456".
For detailed information regarding configuration, please refer to our Configuration Guide, or click the "Help" link at the top of each page.
  • If your server uses a firewall, please make sure that localhost is trusted.
For instance, Linux with IPTables should include a rule ALLOW INPUT from LO.
  • If your website and the WebAdmin console are inaccessible, please take a look at the error log /usr/local/lsws/logs/error.log.
If there is a TCP port conflict with other server applications, you will need to stop the application currently running on port 7080. The following command can be used to check port 7080: netstat -an | grep 7080. If the port is available, the command will produce no output.
If the swapping directory is not writable, you can either grant writing permission for the swapping directory to the user whom the web server is running as, or change the swapping directory's configurations manually. The swapping directory is configured in the server's XML configuration file: /usr/local/lsws/conf/httpd_config.xml. Search the XML file for "swappingDir". The default location for the swapping directory is /tmp/lshttpd/swap.
If you still have problems with installation, please check the OpenLiteSpeed Development Group.


  • OpenLiteSpeed supports both native LiteSpeed XML configuration files and plain text configuration files (for those used to editing Apache's httpd.conf). Run /usr/local/lsws/conf/ to switch between these formats.
  • On FreeBSD, Mac OS X, Ubuntu, and Debian, the shipped PHP (for CentOS) will not run. You will need to build a new PHP for OpenLiteSpeed in order to run PHP applications with OpenLiteSpeed. PHP can be built in the WebAdmin console > Actions > Compile PHP.

Uninstallation Steps

  • Stop OpenLiteSpeed if it is running: [your_install_dir]/bin/lswsctrl stop
  • Remove the install directory: rm -rf [your_install_dir]


You can change your OpenLiteSpeed version by simply installing a different version of OpenLiteSpeed. Re-installing will not affect your configuration files.