Change Document Root for Primary Domain

How to change the document root for the primary domain of a cPanel account.

Related Articles

Modify Document Root for Addon Domain

Change Document Root for Primary Domain

IMPORTANT: This solution is only available on VPS and Dedicated hosting plans.

1. SSH into the relevant server as root
2. Edit both /var/cpanel/userdata/userna5/domain.com and /var/cpanel/userdata/userna5/domain.com_SSL
   REPLACE: userna5 with the cPanel user and domain.com with the primary domain.

3. Change documentroot: /home/userna5/public_html and path: /home/userna5/public_html/cgi-bin to documentroot: /home/userna5/new_doc_root_dir and path: /home/userna5/new_doc_root_dir/cgi-bin

   REPLACE: userna5 with the cPanel user and new_doc_root_dir with the new document root.
   EXAMPLE: The document root for imhkmc5 was updated from public_html to public_html/public, a common request for Laravel sites.
   

4. Rebuild Apache /scripts/rebuildhttpdconf​
5. Restart Apache /scripts/restartsrv_httpd​ --graceful
6. If using PHP-FPM, edit /var/cpanel/userdata/userna5/domain.com.php-fpm.yaml
   REPLACE: userna5 with the cPanel user and domain.com with the domain.

7. Change php_admin_value_doc_root: /home/userna5/public_html​ to php_admin_value_doc_root: /home/userna5/new_doc_root_dir

   REPLACE: userna5 with the cPanel user and new_doc_root_dir with the new document root.
   NOTE: If the line does not exist, add it.
   EXAMPLE:
   

8. Rebuild PHP-FPM /scripts/php_fpm_config --rebuild​
9. Restart PHP-FPM /scripts/restartsrv_apache_php_fpm​
10. If NGINX is installed
    1. Rebuild ngxconf ngxconf -u userna5 -rdF && ngxutil -Xu userna5
       REPLACE: userna5 with the cPanel username.
    2. Restart NGINX systemctl restart nginx​