Documentation — EduNexus Installation & Setup Guide

Server Requirements

Before installing EduNexus, ensure your server meets these requirements:

Requirement	Minimum	Recommended
PHP Version	PHP 8.2+	PHP 8.3+
Database	MySQL 8.0+	MySQL 8.0+ or MariaDB 10.6+
Web Server	Apache/Nginx	Nginx with try_files
RAM	512 MB	1 GB+
Disk Space	200 MB	1 GB+ (for uploads)
Composer	2.x	2.x latest
SSL Certificate	Required	Let's Encrypt (free)

Required PHP Extensions: BCMath, Ctype, cURL, DOM, GD or Imagick, JSON, Mbstring, OpenSSL, PDO, pdo_mysql, Tokenizer, XML, Zip

💡 Most modern shared hosting providers (cPanel-based) include all required extensions by default. Contact your host if you're unsure.

Quick Start (5 Minutes)

The fastest path from zero to live:

Upload Files

Upload all files to your server. Set the public/ directory as your web root (document root).

Run Composer

composer install --optimize-autoloader --no-dev

Create Database

Create an empty MySQL database and note the credentials (host, name, username, password).

Run Web Installer

Visit https://yourdomain.com/install in your browser and follow the 5-step wizard.

You're Live!

Detailed Installation Guide

1. Upload Files

Upload all contents of the ZIP package to your server. For most shared hosting setups using cPanel File Manager or FTP:

Upload everything into a directory (e.g., /home/user/edunexus/)
Set /home/user/edunexus/public as the document root for your domain
This ensures only public-facing files are web-accessible

⚠️ Never expose the root directory as your web root. Only the public/ folder should be accessible from the web.

2. Install Dependencies

# Navigate to your installation directory
cd /home/user/edunexus

# Install PHP dependencies
composer install --optimize-autoloader --no-dev

3. File Permissions

chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache

4. Web Installer

Visit https://yourdomain.com/install. The wizard covers:

Step 1: Server requirements check
Step 2: Database configuration
Step 3: Application settings (name, URL, timezone)
Step 4: Admin account creation
Step 5: Installation complete

Post-Install Checklist

After the installer completes, run these commands for optimal performance:

php artisan config:cache
php artisan route:cache
php artisan view:cache
php artisan storage:link

💡 Run these commands after any configuration change or update deployment.

Cron Job Setup

EduNexus uses scheduled tasks for reminders, cache warming, and notifications. Add this cron entry:

# Run every minute — required for scheduled tasks
* * * * * cd /path/to/edunexus && php artisan schedule:run >> /dev/null 2>&1

Replace /path/to/edunexus with your actual installation path (the root, not public/).

Mail Configuration

Configure SMTP in Admin Panel → Settings → Email after installation. Supported drivers: SMTP, Mailgun, SendGrid, Amazon SES, or PHP mail().

Stripe Payment Setup

To enable online fee collection via Stripe:

Create a Stripe account at stripe.com
Get your Publishable Key and Secret Key from the Stripe Dashboard
Enter them in Admin Panel → Settings → Payment
Configure your webhook endpoint for payment confirmations

License Activation

After purchase, you receive a license key via email (format: EN-XXXX-XXXX-XXXX-XXXX).

Log in to Admin Panel

Go to https://yourdomain.com/admin and log in with your Super Admin credentials.

Navigate to License Settings

Go to Settings → License in the sidebar.

Enter License Key

Paste your license key into the field and click Activate. The system verifies it against your domain.

Confirmation

A green status indicator confirms your license is active. The system caches validation for 7 days.

You can also activate your license at https://license-edunexus.epexlogics.com.

Domain Transfer

If you need to move EduNexus to a different domain:

Go to Admin Panel → Settings → License
Click "Request Domain Change"
Enter your new domain and submit
Contact support to approve the transfer — response within 24 hours

⚠️ You can transfer your license up to 2 times per year. Domain transfers are not immediate and require manual approval.

User Roles

Role	Scope	Key Capabilities
Super Admin	System-wide	All branches, license, global settings, user management
Branch Admin	Single branch	Students, teachers, fees, exams, timetables, announcements
Teacher	Assigned classes	Attendance, assignments, study materials, Zoom links, grades
Student	Own data	Timetable, results, assignments, study materials, fees
Parent	Child's data	Fee payment, results, attendance, announcements
Staff	Limited	Schedule view, announcements, limited admin functions

FAQ for Buyers

I purchased. How do I download?+

Log in to your account at license-edunexus.epexlogics.com. Go to My Licenses → Downloads and download the installable package ZIP file.

Where is my license key?+

Your license key is emailed to you immediately after purchase. You can also find it anytime in your account at license-edunexus.epexlogics.com under My Licenses.

Can I install on localhost?+

Yes, for development. For production use, the license must be activated on a public domain.

Do I get the full source code?+

Yes. The full Laravel source code is included. There are no obfuscated files.

How do I update to newer versions?+

Log in to license-edunexus.epexlogics.com, go to My Licenses → Downloads and download the latest version. Follow the update instructions in the changelog — typically a file replacement and a few artisan commands.

Getting Support

Support is provided via email or the contact form. Include these details in your support request:

Your license key (from license-edunexus.epexlogics.com)
PHP version (run php -v)
Server/hosting provider
Steps to reproduce the issue
Any error messages from storage/logs/laravel.log

💡 Response time: within 24 hours (Mon–Fri). Priority support is available on Professional and Enterprise plans.

Contact Support →

EduNexus Documentation

Getting Started

Configuration

License

Reference