🚀 Quick Start Installation Guide¶

Welcome! This guide will help you install NewWaves Hospital Management System on shared hosting using our automatic installation wizard.

✨ What Makes This Easy¶

Your Hospital Management System includes a powerful web-based installation wizard that handles all the complex setup automatically. No command line knowledge required!

🎯 Installation Time: 10-15 minutes
💻 Skill Level: Beginner-friendly
🛠️ Requirements: Just web hosting with PHP and MySQL

📋 Pre-Installation Requirements¶

Hosting Requirements¶

PHP: 8.1 or higher
Database:MariaDB 10.3+
Storage: At least 500MB free space
Memory: Minimum 256MB RAM

PHP Extensions (Most hosting providers include these)¶

BCMath, Ctype, Fileinfo, JSON, Mbstring
OpenSSL, PDO, Tokenizer, XML, ZIP
GD, cURL extensions

What You'll Need¶

🚀 Installation Steps¶

Step 1: Upload Files to Your Hosting¶

Option A: Using cPanel File Manager (Recommended)¶

Login to your hosting cPanel
Open "File Manager"
Navigate to public_html folder
Upload the NewWaves Hospital Management ZIP file
Right-click and "Extract" the ZIP file
Delete the ZIP file after extraction

Option B: Using FTP¶

Extract the ZIP file on your computer
Upload all files to your domain's root folder via FTP
Ensure all files uploaded completely

Step 2: Set File Permissions¶

Using cPanel: - Right-click storage folder → Change Permissions → Set to 755 - Right-click bootstrap/cache folder → Change Permissions → Set to 755 - Check "Recurse into subdirectories" for both

Step 3: Start Installation Wizard¶

Visit your website: https://yourdomain.com
Automatic redirect: System will redirect to /install
Installation wizard starts with welcome screen

🎯 Installation Wizard Walkthrough¶

Step 1: Welcome Screen¶

Review product information and features
System overview
Click "Start Installation"

Step 2: System Requirements Check¶

Automatic verification of PHP version and extensions
Permission checks for directories
Auto-fix functionality for common issues
Green checkmarks = Ready to proceed ✅

Step 3: Database Configuration¶

Database Host: localhost (usually)
Database Port: 3306 (usually)
Database Name: Your database name
Username & Password: Your database credentials
Click "Test Connection" to verify
Automatic database setup with progress bar

Step 4: Administrator Setup¶

Admin Name: Your full name
Email Address: Your admin email
Password: Strong password (8+ characters)
Phone Number: Optional
Click "Create Admin Account"

Step 5: Installation Complete! 🎉¶

Final optimizations completed automatically
Success confirmation with login details
Access links to all system areas

🔑 Access Your System¶

After successful installation:

🏥 Admin Dashboard: https://yourdomain.com/admin
👨‍⚕️ Staff Portal: https://yourdomain.com/login
👤 Patient Portal: https://yourdomain.com/patient
🌐 Public Website: https://yourdomain.com

⚡ Post-Installation Tips¶

1. Security First¶

Change default admin password immediately
Enable SSL certificate (HTTPS) if not already active

2. Basic Configuration¶

Upload your hospital logo
Configure SMTP email settings
Set up your hospital information
Create staff accounts

3. Optional Enhancements¶

Set up automatic backups through your hosting provider
Configure CDN if you have high traffic expectations
Enable caching in your hosting control panel

❓ Troubleshooting¶

Installation wizard won't start?¶

Check file permissions (storage and bootstrap/cache = 755)
Ensure all files uploaded completely
Try manually visiting /install

Database connection fails?¶

Double-check database credentials with your hosting provider
Ensure database exists and user has full permissions
Try localhost or 127.0.0.1 as database host

PHP requirements not met?¶

Contact your hosting provider to enable required PHP extensions
Request PHP version upgrade if below 8.1

🆘 Need Help?¶

If you encounter any issues: 1. Check our detailed Online Installation Guide 2. Review the troubleshooting section

Remember: The installation wizard handles 95% of the work automatically. Most installations complete successfully in under 10 minutes!

🎉 Ready to transform your hospital management? Let's get started! command=php /path/to/your/project/artisan queue:work --sleep=3 --tries=3 autostart=true autorestart=true user=www-data numprocs=4 redirect_stderr=true stdout_logfile=/path/to/your/project/worker.log

### 4. Performance Optimization
```bash
# Cache configuration
php artisan config:cache
php artisan route:cache
php artisan view:cache

# Optimize composer autoloader
composer install --optimize-autoloader --no-dev

# Clear unnecessary files
php artisan clear-compiled

🧪 Testing Installation¶

1. Basic Functionality Test¶

[ ] Admin login works
[ ] Patient registration works
[ ] Appointment booking works
[ ] Email notifications work
[ ] File uploads work

2. Performance Test¶

# Check application status
php artisan about

# Test database connection
php artisan tinker
> DB::connection()->getPdo();

🚨 Troubleshooting¶

Common Issues¶

1. Permission Errors

sudo chown -R www-data:www-data storage bootstrap/cache
sudo chmod -R 775 storage bootstrap/cache

2. 500 Internal Server Error - Check Laravel logs: storage/logs/laravel.log - Ensure .env file exists and is properly configured - Verify database connection

3. Assets Not Loading

# Rebuild assets
npm run build

# Clear cache
php artisan cache:clear
php artisan view:clear

4. Database Connection Failed - Verify database credentials in .env - Ensure database server is running - Check firewall settings

Getting Help¶

If you encounter issues:

Check Logs: storage/logs/laravel.log
Debug Mode: Set APP_DEBUG=true temporarily
Clear Cache: Run php artisan cache:clear
Contact Support: Email us with error details

✅ Installation Checklist¶

[ ] Server requirements met
[ ] Files uploaded and extracted
[ ] Dependencies installed
[ ] Environment configured
[ ] Database created and migrated
[ ] Assets built
[ ] Permissions set
[ ] Web server configured
[ ] Admin credentials changed
[ ] SSL configured (recommended)
[ ] Cron jobs set up
[ ] Performance optimized
[ ] Installation tested

🎉 Congratulations! Your NewWaves Hospital Management System is now ready to use!

For additional support, please refer to the User Manual or contact our support team at info@newwavesprojects.com