How To: Customize the Apache DocumentRoot
=========================================

The Apache DocumentRoot can be changed using the InterWorx Config System. 

This change will persist if the domain is restored or imported from a backup.   

To Update a Single Domain
-------------------------

#. Log in to the server at the CLI as root, either via SSH or from the terminal
#. Run the following command, specifying the domain and path to the desired DocumentRoot:

   .. code-block::

       ~iworx/bin/config.pex --set --domain {domain} --name HTTPD_DOCUMENT_ROOT --value /home/{unixuser}/{/path/to/docroot}/

#. Rewrite the vhost file for the domain

   .. code-block::   
      
       ~iworx/bin/httpd.pex --write-vhost --domain {domain}
   
#. Reload Apache  

   .. code-block::

       systemctl reload httpd.service