How To: Use the CloudLinux Plugin in SiteWorx
=============================================

.. contents::
  
SiteWorx users may manage CloudLinux tools from the SiteWorx interface. There are four options:

- PHP Selector
- NodeJS Selector: Further information can be found in the CloudLinux documentation regarding the `Node.JS Selector <https://docs.cloudlinux.com/lve_manager/#node-js-selector-2>`_.
- Python Selector: Further information can be found in the CloudLinux documentation regarding the `Python Selector <https://docs.cloudlinux.com/lve_manager/#python-selector-2>`_.
- Resource Usage: Will be included in a future version of InterWorx

.. note::

  Users who do not see CloudLinux listed as an option in SiteWorx should contact their hosting provider to be granted access.

Enabling the CloudLinux PHP Selector 
------------------------------------

   To use the CloudLinux PHP Selector, the domain must first be set to "PHP Native (CloudLinux)" in SiteWorx.

   #. Log into SiteWorx from the browser (https://ip.ad.dr.ess:2443/siteworx)
   #. In SiteWorx, navigate to **Hosting Features > Domains > Manage**, either from the side menu or SiteWorx home
   #. Click the **Pencil** next to the domain. This opens the Edit Secondary Domain form

      .. note:: 

         The form will say Edit Secondary Domain, even if the domain is the master. This is expected behavior.

   #. Select **PHP Native (CloudLinux)** from the PHP Version dropdown

      .. image:: /images/sw-cloud-linux-change-php-version.png
         :alt: siteworx cloud linux change php version form 

   #. Click **Save**

Changing the CloudLinux PHP version
-----------------------------------

   Once the above steps are completed, to set and/or change the CloudLinux PHP version:
   
   #. Log into SiteWorx from the browser (https://ip.ad.dr.ess:2443/siteworx)
   #. Navigate to **CloudLinux > PHP Selector**, either from the side menu or SiteWorx home
   #. Select the **desired PHP version** from the PHP Version dropdown. This opens the PHP Selector Extensions form

      .. image:: /images/sw-cloudlinux-php-options.png
         :alt: siteworx cloud linux php options 
   
   #. Select the desired PHP extensions to install, if any, by selecting the **checkbox** next to the name of 
      the extension

      .. image:: /images/sw-cloud-linux-php-extensions.png
         :alt: siteworx cloud linux php extensions 

   #. Click **Set As Current**