Magento 2

How Can We Help?
< Back

Install: Quick Install Magento 2

After you install OpenLiteSpeed, follow the instructions below to get your Magento 2 site working.

      1. Install PHP modules
      2. MariaDB Installation
      3. Create MagentoDB Account
      4. Create a Magento User
      5. Download and Extract Magento
      6. Create a Virtual Host for Magento
      7. Run the Magento install script
      8. Good Pratice: Changing doc_root to /pub/

      Install PHP Modules

      The easiest way to install PHP for OpenLiteSpeed (without ols1clk) is through our CentOS/Ubuntu/Debian repository. If the LiteSpeed Repository was not installed and enabled during the web server installation, follow this guide to install and enable the LiteSpeed Repository.

      Installing PHP for OLS includes installing RPM or APT packages, setting up LSPHP external apps, and setting up script handlers. Please refer to this wiki for details.

      Magento 2.3.1 is certified and tested on PHP 7.2.11, so you can run the following command to install LSPHP72:


      yum install lsphp72 lsphp72-mysqlnd lsphp72-common lsphp72-gd lsphp72-pdo lsphp72-process lsphp72-mbstring lsphp72-mcrypt lsphp72-opcache lsphp72-bcmath lsphp72-xml lsphp72-soap lsphp72-json lsphp72-intl -y


      apt-get install lsphp72 lsphp72-mysqlnd lsphp72-common lsphp72-gd lsphp72-pdo lsphp72-process lsphp72-mbstring lsphp72-mcrypt lsphp72-opcache lsphp72-bcmath lsphp72-xml lsphp72-soap lsphp72-json  -intl -y

      then set up the internal app pointing to the newly installed LSPHP binary. Lastly set up the script handler.

      MariaDB/MySQL Installation

      On CentOS, run the following to install MariDB:

      yum install mariadb-server

      On Ubuntu/Debian, you will need to install MySQL instead of MariaDB.

      apt-get install mysql-server

      Start MariaDB/MySQL server:

      systemctl start mysql

      Set a new password:


      Enter $yourpassword

      Create a Magento Database Account

      mysql -u root -p'yourmysqlpassword'
      create database magento; 
      grant all privileges on magento.* to magento@localhost identified by 'magento-database-password'; 

      Create a Magento User

      To better isolate your applications, let’s create a user only for Magento.

      Create magento2 user:

      useradd magento2

      Change magento2 password:

      passwd magento2

      Download and Extract Magento

      Now we can download Magento 2 from their official page and prepare our file structure for the next steps.

      cd /home/magento2/public_html/
      ### copy to here
      unzip Magento-*.zip 
      ### Change files permission
      chown -R magento2:  /home/magento2/public_html/

      Create a Virtual Host

      You need to create a new Virtual Host. Go to OLS Admin Console -> Configuration ->  Virtual Hosts and click on the ‘ + ‘ (Add) sign.

      Configure the values according to your situation. When you finish, click on the Save icon. It will complain about the config file not existing. Just click on ‘CLICK TO CREATE’ and try to save again.

      Next, you will be redirected to Virtual Hosts Summary again. Click on the Virtual Host you just created to open its options and continue to do the basic configuration.

      At the beginning, you should configure Magento Document Root as: /home/magento2/public_html/

  2.      You MUST enable Rewrites and “Auto Load from .htaccess” also. Magento 2 relies on .htaccess to work properly. Assuming your PHP, Script Handler, log and other options are already set, you can now save everything and reload OpenLiteSpeed by clicking on the Graceful Restart button.

    Run the Magento Install Script

    Step 1. Run Installation Script

    Point your browser with default port to
    Accept terms and conditions by clicking ‘Accept and Setup Magento’.

    Step 2. Readiness Check

    Magento CE installer needs to check if all the requirements are met. If you have followed all the guidelines above, all the requirements should be met, so just click ‘Start Readiness Check’.


    Step 3. Set up Database

    We’ve created the database above. Just enter the database details and click Save and continue. If the Magento installer is successfully able to connect to the database, it will start the installation process.

    Enter the database details we created above.

    Step 4. Web Configuration

    Set up your Store and Admin URL Path, e.g.

    Step 5. Create Admin Account

    On this step, the installer will let you configure settings for your site. Example settings are:

    • Site name: Litespeedtech
    • Site email address:
    • Username: litespeedtech
    • Password: litespeedtech

    Step 6. Install

    Good Practice: Change document root

  3. IMPORTANT NOTE: Magento 2 should never run on its root file structure on a production server like we just configured. After installing it, you must set its Document Root to /home/magento2/public_html/pub/, or else you can have a lot of problems with redirect loops, security, etc. No matter what file structure you are using, Magento Document Root must always point to “your-file-structure/pub” after installing.


  1. Setting the webroot to the pub/ directory prevents site visitors from accessing the Web Setup Wizard and other sensitive areas of the Magento file system from a browser.
    If you’re accustomed to using the Web Setup Wizard during development, be aware that you will not be able to access it when serving files from the pub/ dir.
  2. Please refer to this Magento 2 office document for doc root recommendation
    1. Cannot use LiteMage on OLS

      Although the LiteMage cache plugin is free, it will require LiteSpeed Enterprise to make it work. Installing LiteMage on OLS won’t work.