Installation

Let's begin the installation of the XSender Application. But first, let's go over some important precautions.

⚙️ Installation Process

This guide explains how to install XSender from the CodeCanyon ZIP file.

If you are new — don’t worry. Just follow step by step.

📦 Step 1 — Upload ZIP File

After purchasing from CodeCanyon:

1. Download All Files & Documentation

2. Upload the ZIP file to your VPS server:

/var/www/xsender/

📂 Step 2 — Extract Files

SSH into your server:

cd /var/www/xsender/
unzip xsender-installer-vxx.zip

After extraction, your folder should contain:

assets/
src/
xsender-whatsapp-service/
.htaccess
config.json
index.php

🌐 Step 3 — Set Document Root

Set your web server (Apache/Nginx) document root to:

/var/www/xsender/

⚠️ Important:

✅ Site root = Main XSender folder
❌ Do NOT use src/public

We modified Laravel structure to make installation easier.

🌐 Shared Hosting — cPanel Installation

Use this only if you do not have VPS.

Performance will be slower than VPS.

📦 Step 1 — Upload ZIP

1. Login to cPanel

2. Open File Manager

3. Go to public_html

4. Upload the ZIP file

5. Click Extract

After extraction, public_html should contain:

assets/
src/
xsender-whatsapp-service/
.htaccess
config.json
index.php

⚠️ Important for cPanel

Do NOT move files into src/public.

Your domain must directly load from:

public_html/

🖥 aaPanel Installation

1. Login to aaPanel

2. Go to Website

3. Set site root to your domain folder

4. Upload ZIP file

5. Extract inside root folder

Your root must contain:

assets/
src/
xsender-whatsapp-service/
.htaccess
index.php

🌍 Run the Installer

After uploading and extracting:

Open your browser:

yourdomain.com/install

Installer will start automatically.

If you see 404 error:

• Check site root

• Make sure .htaccess exists

• Enable mod_rewrite

📸 Screenshot: Installer welcome page

🧪 Requirements Check

Installer verifies:

• PHP 8.2+

• Required extensions

• File permissions

All must be green.

Click Next.

🔑 License Verification

Enter:

• Purchase Code

• Envato Username

Click Verify.

🗄 Database Setup

Create a MySQL database first.

Enter:

• Host (usually localhost)

• Database Name

• Username

• Password

Click Save & Continue.

👤 Create Admin Account

Enter:

• Username

• Email

• Password

Click Install.

Wait until installation completes.

✅ Installation Complete

Access:

Website / Frontend:

yourdomain.com

Admin Panel:

yourdomain.com/admin

User Panel:

yourdomain.com/login

Login using your admin credentials.