Docroot-based PHP Deploy (CloudPanel)

Create the PHP site once in CloudPanel, then use this panel or Git Bash to deploy/update your project ZIP into its document root.

How to deploy a new domain + ZIP (UI method)

CloudPanel → Sites → Add Site → Create a PHP Site.
Application: Generic, set your Domain (e.g. laptop.myvpspanels.cloud) and PHP version (e.g. 8.2).
After site is created, open its Settings in CloudPanel and note:
• Domain
• Document Root (e.g. /home/myvpspanels-laptop/htdocs/laptop.myvpspanels.cloud)
• Site User / Linux User (e.g. myvpspanels-laptop)
Open this deploy panel (index.php on your admin subdomain). Fill these fields exactly as in CloudPanel:
• Domain
• Document Root Path
• Linux User
(Use the Copy/Paste buttons for safety.)
Choose how to provide your project ZIP:
• Upload ZIP → select file from your PC (e.g. laptops.zip)
• Existing ZIP Path → type a name like laptops.zip (inside docroot) or full path like
/home/myvpspanels-laptop/htdocs/laptop.myvpspanels.cloud/laptops.zip
Enable options as per project:
• Clean docroot before deployment → for fresh deploy
• Install Let's Encrypt SSL → if DNS already points to this server
• Run Composer → for Laravel / heavy PHP apps
• Apply Nginx profile rules → for pretty URLs (hide .php, etc.)
Click Deploy Website. Logs on the right will show every step (clean, unzip, chown, SSL, Nginx reload). On success, final line will be: 🎉 Deployment completed successfully! Visit: https://your-domain
Finally, open your site in browser:
https://laptop.myvpspanels.cloud

How to deploy from local (Git Bash script)

If you prefer deploying directly from your Windows PC using Git Bash, use deploy-from-local.sh.

Place your ZIP on Desktop, e.g.
/c/Users/NKM/OneDrive/Desktop/laptops.zip
Make sure CloudPanel site already exists (same steps as left card: Add Site, note docroot + user).

In Git Bash:

cd "/c/Users/NKM/OneDrive/Desktop"

./deploy-from-local.sh \
  laptop.myvpspanels.cloud \
  /home/myvpspanels-laptop/htdocs/laptop.myvpspanels.cloud \
  laptops.zip

The script will:
• Upload laptops.zip to /root/ on the VPS
• Call /root/deploy-docroot.sh with domain + docroot + ZIP
• Clean docroot, unzip project, fix permissions, install SSL, and inject Nginx pretty URL profile
When you see this in Git Bash:
== 🎉 Done → Visit: https://laptop.myvpspanels.cloud ==
your new PHP site is live.

Pattern for any new domain:
1) Create PHP site in CloudPanel → get DOMAIN, DOCROOT, Linux User
2) Create/update ZIP
3) Run deploy-from-local.sh DOMAIN DOCROOT ZIP or use the UI form on the left.

Deployment Settings

Ready

Domain

Must match the domain configured in CloudPanel (and DNS pointing to this server).

Document Root Path

Exact docroot of this site as configured in CloudPanel.

Linux User

Owner of files (CloudPanel Linux user).

App Type / Profile

For your laptop project, choose Laptop Project (PHP) or Simple PHP.

Project ZIP

Upload ZIP Existing ZIP Path

Upload project ZIP

Example: laptops.zip

Options

Clean docroot before deployment Removes all files in docroot (except the ZIP if stored inside). Install Let's Encrypt SSL Runs clpctl lets-encrypt:install:certificate --domainName=<domain>. Run Composer install (if composer.json exists) Executes composer install --no-dev --optimize-autoloader inside docroot. Apply Nginx profile rules automatically For Simple PHP / Laptop Project this adds working pretty URL rules. For WordPress/Laravel, injects snippets as comments.

Deployment Logs

No logs yet. Follow the instructions above, fill the form on the left and click Deploy Website.

Tip: Use this panel internally only (IP allowlist, HTTP auth, or VPN).