| Server IP : 202.155.9.250 / Your IP : 216.73.217.178 Web Server : LiteSpeed System : Linux srv339029361 5.15.0-177-generic #187-Ubuntu SMP Sat Apr 11 22:54:33 UTC 2026 x86_64 User : bigas1846 ( 1044) PHP Version : 8.0.30 Disable Function : pcntl_alarm,pcntl_fork,pcntl_waitpid,pcntl_wait,pcntl_wifexited,pcntl_wifstopped,pcntl_wifsignaled,pcntl_wifcontinued,pcntl_wexitstatus,pcntl_wtermsig,pcntl_wstopsig,pcntl_signal,pcntl_signal_get_handler,pcntl_signal_dispatch,pcntl_get_last_error,pcntl_strerror,pcntl_sigprocmask,pcntl_sigwaitinfo,pcntl_sigtimedwait,pcntl_exec,pcntl_getpriority,pcntl_setpriority,pcntl_async_signals,pcntl_unshare, MySQL : OFF | cURL : ON | WGET : ON | Perl : ON | Python : OFF | Sudo : ON | Pkexec : ON Directory : /usr/local/lsws/docs/ |
Upload File : |
<!DOCTYPE html>
<html lang="en-US">
<head>
<meta charset="utf-8" />
<meta http-equiv="X-UA-Compatible" content="IE=edge,chrome=1" />
<title>OpenLiteSpeed Users' Manual - Installation</title>
<meta name="description" content="OpenLiteSpeed Users' Manual - Installation." />
<meta name="viewport" content="width=device-width, initial-scale=1.0" />
<meta name="robots" content="noindex">
<script>
(function () {
var theme = 'light';
var resolved = false;
try {
if (window.localStorage) {
var storedTheme = window.localStorage.getItem('hdoc.theme');
if (storedTheme === 'light' || storedTheme === 'dark') {
theme = storedTheme;
resolved = true;
}
}
} catch (err) {
}
if (!resolved && window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches) {
theme = 'dark';
}
document.documentElement.setAttribute('data-theme', theme);
document.documentElement.style.colorScheme = theme;
}());
</script>
<link rel="shortcut icon" href="img/favicon.ico" />
<link rel="stylesheet" type="text/css" href="css/hdoc.css">
<link rel="stylesheet" type="text/css" href="css/hdoc-product-accent.css">
<script src="hdoc-search-index.js" defer></script>
<script src="js/hdoc-search.js" defer></script>
</head>
<body>
<div class="doc-shell">
<header class="doc-topbar">
<a class="doc-brand" href="index.html" aria-label="OpenLiteSpeed Users' Manual">
<img src="img/ols_logo.svg" alt="OpenLiteSpeed logo" />
<strong>OpenLiteSpeed Users' Manual</strong>
</a>
<div class="doc-actions">
<button class="doc-menu-toggle" type="button" aria-label="Open menu" data-menu-toggle aria-expanded="false">
<svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M3 12h18M3 6h18M3 18h18" stroke="currentColor" stroke-width="2" stroke-linecap="round"/></svg>
</button>
<form class="doc-search" role="search" data-empty="Search pages and settings" data-no-results="No results found.">
<label class="sr-only" for="doc-search-input">Search the manual</label>
<div class="doc-search__box">
<input id="doc-search-input" type="search" autocomplete="off" placeholder="Search pages and settings" aria-controls="doc-search-results" />
<button type="submit">Search</button>
</div>
<div id="doc-search-results" class="doc-search__results" hidden></div>
</form>
</div>
<label class="doc-language"><select id="doc-language-switcher" name="doc_language" data-language-switcher aria-label="Language"><option value="install.html" data-lang="en-US" selected>English</option><option value="es-ES/install.html" data-lang="es-ES">Español</option><option value="de-DE/install.html" data-lang="de-DE">Deutsch</option><option value="fr-FR/install.html" data-lang="fr-FR">Français</option><option value="zh-CN/install.html" data-lang="zh-CN">简体中文</option><option value="ja-JP/install.html" data-lang="ja-JP">日本語</option></select></label>
<button class="doc-theme-toggle" type="button" aria-label="Toggle theme" data-theme-toggle data-theme-light-label="Light mode" data-theme-dark-label="Dark mode" title="Toggle theme">
<span class="doc-theme-toggle__icon" aria-hidden="true"></span>
</button>
</header>
<div class="doc-menu-backdrop" data-menu-backdrop></div>
<div class="pagewrapper" data-current-lang="en-US" data-supported-langs="["en-US","es-ES","de-DE","fr-FR","zh-CN","ja-JP"]"><aside class="sidetree"><div class="sidetree__masthead"><figure class="sidetree__figure"><img src="img/ols_logo.svg" alt="OpenLiteSpeed logo" /></figure><div class="sidetree__identity"><a class="sidetree__manual-link" href="index.html">Users' Manual</a><div class="sidetree__version">Version 1.9 — Rev. 4</div></div></div><nav class="sidetree__nav" aria-label="Table of Contents"><ul class="sidetree__list">
<li><a href="license.html">License</a></li>
<li><a href="intro.html">Introduction</a></li>
<li><a class="current" href="install.html">Installation/Uninstallation</a></li>
<li>
<a href="admin.html">Administration</a>
<ul class="level2">
<li><a href="ServerStat_Help.html">Service Manager</a></li>
<li><a href="Real_Time_Stats_Help.html">Real-Time Stats</a></li>
</ul>
</li>
<li><a href="security.html">Security</a></li>
<li>
<a href="config.html">Configuration</a>
<ul class="level2">
<li><a href="ServGeneral_Help.html">Server General</a></li>
<li><a href="ServLog_Help.html">Server Log</a></li>
<li><a href="ServTuning_Help.html">Server Tuning</a></li>
<li><a href="ServSecurity_Help.html">Server Security</a></li>
<li>
<a href="ExtApp_Help.html">External Apps</a>
<ul class="level3">
<li><a href="External_LSAPI.html">LSAPI App</a></li>
<li><a href="External_WS.html">Web Server (Proxy)</a></li>
<li><a href="External_FCGI.html">Fast CGI App</a></li>
<li><a href="External_FCGI_Auth.html">Fast CGI Authorizer</a></li>
<li><a href="External_SCGI.html">Simple CGI App</a></li>
<li><a href="External_Servlet.html">Servlet Engine</a></li>
<li><a href="External_PL.html">Piped Logger</a></li>
<li><a href="External_LB.html">Load Balancer</a></li>
<li><a href="External_UWSGI.html">uWSGI</a></li>
</ul>
</li>
<li><a href="ScriptHandler_Help.html">Script Handler</a></li>
<li><a href="App_Server_Help.html">App Server Settings</a></li>
<li><a href="Module_Help.html">Module Configuration</a></li>
<li><a href="Listeners_General_Help.html">Listener General</a></li>
<li><a href="Listeners_SSL_Help.html">Listener SSL</a></li>
<li><a href="Templates_Help.html">Virtual Host Templates</a></li>
<li><a href="VirtualHosts_Help.html">Virtual Host Registration</a></li>
<li><a href="VHGeneral_Help.html">Virtual Host General</a></li>
<li><a href="VHSecurity_Help.html">Virtual Host Security</a></li>
<li><a href="VHSSL_Help.html">Virtual Host SSL</a></li>
<li><a href="Rewrite_Help.html">Rewrite</a></li>
<li>
<a href="Context_Help.html">Context</a>
<ul class="level3">
<li><a href="Static_Context.html">Static Context</a></li>
<li><a href="Java_Web_App_Context.html">Java Web App Context</a></li>
<li><a href="Servlet_Context.html">Servlet Context</a></li>
<li><a href="FCGI_Context.html">Fast CGI Context</a></li>
<li><a href="SCGI_Context.html">Simple CGI Context</a></li>
<li><a href="LSAPI_Context.html">LSAPI Context</a></li>
<li><a href="Proxy_Context.html">Proxy Context</a></li>
<li><a href="CGI_Context.html">CGI Context</a></li>
<li><a href="LB_Context.html">Load Balancer Context</a></li>
<li><a href="Redirect_Context.html">Redirect Context</a></li>
<li><a href="App_Server_Context.html">App Server Context</a></li>
<li><a href="UWSGI_Context.html">uWSGI Context</a></li>
<li><a href="Module_Context.html">Module Handler Context</a></li>
</ul>
</li>
<li><a href="VHWebSocket_Help.html">Web Socket Proxy</a></li>
</ul>
</li>
<li><a href="webconsole.html">Web Console</a>
<ul class="level2">
<li><a href="AdminGeneral_Help.html">Admin Console General</a></li>
<li><a href="AdminSecurity_Help.html">Admin Console Security</a></li>
<li><a href="AdminListeners_General_Help.html">Admin Listener General</a></li>
<li><a href="AdminListeners_SSL_Help.html">Admin Listener SSL</a></li>
</ul>
</li>
</ul></nav></aside><article class="contentwrapper"><div class="nav-bar"><div class="prev">« <a href="intro.html">Introduction</a></div><div class="center"><a href="index.html">Home</a></div><div class="next"><a href="admin.html">Administration</a> »</div></div>
<h1>Installation/Uninstallation</h1><br/> <h2>Minimum system requirements</h2><br/> <h3>Supported operating systems</h3> <p>OpenLiteSpeed supports current and non-EOL versions of the following Linux distributions:</p> <ul> <li>CentOS* 8, 9, 10</li> <li>Debian 11, 12, 13</li> <li>Ubuntu 20 (EOL May 31, 2025), 22, 24</li> </ul> <p>* Includes RedHat Enterprise Linux and derivatives, AlmaLinux, CloudLinux, Oracle Linux, RockyLinux, VzLinux, etc.</p><br/> <h3>CPU</h3> <ul> <li>Intel: x86-64</li> <li>ARM: aarch64 (Linux only)</li> </ul><br/> <h3>Memory</h3> <p>512MB and up</p><br/> <h3>Disk</h3> <ul> <li>Installation: 200MB</li> <li>Runtime: 300MB and up, swapping space depends on usage.</li> </ul><br/> <h2>Installation</h2> <p> Installation must be performed in a command line terminal. 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. </p><br/> <h3>Installation steps</h3> <p> Visit the <a href="https://docs.openlitespeed.org/" target="_blank" rel="noopener"> OpenLiteSpeed documentation </a> for a list of installation methods. </p><br/> <h2>Getting Started</h2> <ol> <li> <p> For detailed information on controlling the server processes, please see the <a href="admin.html">Administration Guide</a>. </p> <p> To start the server, simply run <span class="cmd">[your_install_dir]/bin/lswsctrl start</span>. (To stop it, run <span class="cmd">[your_install_dir]/bin/lswsctrl stop</span>.) </p> </li> <li> <p>A sample site should be running on the server.</p> <p> To access your site, point your browser to <span class="cmd">http://[address]:8088/</span>, [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. "8088" is the default port. If you chose another port for OpenLiteSpeed during installation, use the port you designated. </p> <p> A congratulations page linked to other testing pages should load into the browser when pointed to the above address. If not, try the WebAdmin Console. </p> </li> <li> <p>The default port for the WebAdmin Console is 7080.</p> <p> Plug <span class="cmd">https://[address]:7080/</span> into your browser to go to the WebAdmin Console. (If you changed the port for WebAdmin during installation, use that port instead.) </p> <p> Remember that for [address] you can use "localhost" if you're currently using the machine the server is on. </p> <p> The WebAdmin Console welcome page should now load. Click the "Log on" link and use the administrator's username and password specified during installation to log on. </p> <p> For detailed information regarding configuration, please refer to our <a href="config.html">Configuration Guide</a>, or click the "Help" link at the top of any page. </p> </li> <li> <p> If your server uses a firewall, please make sure that localhost is trusted. </p> <p> For instance, Linux with IPTables should include a rule <span class="cmd">ALLOW INPUT from LO</span>. </p> </li> <li> <p> If your web site and the WebAdmin Console are inaccessible, please take a look at the error log <span class="cmd">[your_install_dir]/logs/error.log</span>. </p> <p> If there is a TCP port conflict with other server applications, the web server should be reinstalled with an available port. The following command can be used to find an available port: <span class="cmd">netstat -an | grep XXXX</span> XXXX is a port number. If the port is available, the command will produce no output. </p> <p> 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: <span class="cmd">[your_install_dir]/conf/httpd_config.xml</span>. Search the XML file for <span class="cmd">swappingDir</span>. The default location for the swapping directory is <span class="cmd">/tmp/lshttpd/swap</span>. </p> <p> If you still have problems with installation, please see <a href="https://docs.openlitespeed.org/">the documentation</a> or post your problem on our <a href="https://forum.openlitespeed.org/">support forum</a>. </p> </li> </ol><br/> <h2>Note</h2> <ul> <li> OpenLiteSpeed supports both native LiteSpeed XML configuration files and plain text configuration files (for those used to editing Apache's httpd.conf). Run <span class="cmd">[your_install_dir]/conf/switch_config.sh</span> to switch between these formats. </li> </ul><br/> <h2>Uninstallation steps</h2> <ol> <li> Stop OpenLiteSpeed if it is running: <span class="cmd">[your_install_dir]/bin/lswsctrl stop</span> </li> <li> Remove the install directory: <span class="cmd">rm -rf [your_install_dir]</span> </li> </ol> </article></div><button class="doc-back-to-top" type="button" aria-label="Back to top" data-back-to-top><svg viewBox="0 0 24 24" aria-hidden="true" focusable="false"><path d="M12 19V5" /><path d="m6 11 6-6 6 6" /></svg><span class="sr-only">Back to top</span></button><footer class="copyright">Copyright © 2013-2026. <a href="https://www.litespeedtech.com">LiteSpeed Technologies Inc.</a> All rights reserved.</footer>
</div>
</body>
</html>