🚀 NewWaves Hospital Management System - Online Installation Guide¶

Welcome to the complete installation guide for NewWaves Hospital Management System!

This step-by-step guide will help you install and configure your hospital management system in under 30 minutes. Our automated installation wizard handles most of the complex setup, but this guide ensures you don't miss any important steps.

📋 Pre-Installation Checklist¶

✅ Before You Start¶

System Requirements Check: - [ ] PHP 8.1+ installed on your server - [ ] MySQL 8.0+ or MariaDB 10.6+ database available - [ ] Web server (Apache 2.4+ or Nginx 1.18+) running - [ ] At least 512MB RAM available - [ ] SSL certificate installed (recommended for production) - [ ] FTP/cPanel access to your hosting account

Information You'll Need: - [ ] Database name, username, and password - [ ] Your domain URL (e.g., https://yourhospital.com) - [ ] Admin email and password for first account - [ ] SMTP email settings (optional, can configure later)

Files Ready: - [ ] Downloaded ZIP file from CodeCanyon - [ ] Extracted ZIP contents to your computer - [ ] FTP client installed (if using FTP upload)

📁 Step 1: File Upload & Extraction¶

Option A: cPanel File Manager (Recommended for Shared Hosting)¶

Login to your cPanel
Access your hosting provider's cPanel
Navigate to "File Manager"
Upload the ZIP file
Go to your domain's public_html folder (or subdomain folder)
Click "Upload" button
Select the NewWaves Hospital Management ZIP file
Wait for upload to complete
Extract the files
Right-click on the uploaded ZIP file
Select "Extract"
Choose "Extract files to /public_html/" (or your domain folder)
Delete the ZIP file after extraction

Verify file structure

public_html/
├── app/
├── bootstrap/
├── config/
├── database/
├── install-files/
├── public/
├── resources/
├── routes/
├── storage/
├── vendor/ (if included)
├── .env.example
├── composer.json
└── README.md

Option B: FTP Upload¶

Extract ZIP file locally
Extract the ZIP file on your computer
You should see all Laravel application folders
Connect via FTP
Open your FTP client (FileZilla, WinSCP, etc.)
Connect using your FTP credentials
Navigate to your domain's root folder
Upload all files
Select ALL extracted files and folders
Upload to your domain's public folder
This may take 10-20 minutes depending on connection
Verify upload
Ensure all folders uploaded completely
Check that file permissions are correct (755 for folders, 644 for files)

🔧 Step 2: Set File Permissions¶

Required Permissions (Very Important!)¶

Using cPanel File Manager: 1. Select storage folder - Right-click on storage folder - Select "Change Permissions" - Set to 755 (or check: Owner: Read+Write+Execute, Group: Read+Execute, World: Read+Execute) - Check "Recurse into subdirectories" - Click "Change Permissions"

Set bootstrap/cache permissions
Right-click on bootstrap/cache folder
Set permissions to 755 with recursion
Set public/uploads permissions (if folder exists)
Right-click on public/uploads folder
Set permissions to 755 with recursion

Using FTP/SSH:

chmod -R 755 storage/
chmod -R 755 bootstrap/cache/
chmod -R 755 public/uploads/

❗ Important: Without proper permissions, the installation will fail with "permission denied" errors.

🌐 Step 3: Access Installation Wizard¶

Start the Installation Process¶

Open your web browser
Navigate to your domain: https://yourdomain.com
Or if installed in subfolder: https://yourdomain.com/hospital
Automatic redirect
The system will automatically redirect you to: /install
You should see the NewWaves Hospital Management installation welcome screen
If redirect doesn't work
Manually navigate to: https://yourdomain.com/install
Clear your browser cache and try again

🎉 Success Indicator: You should see a professional installation wizard with the NewWaves Hospital Management logo and "Welcome to Installation" message.

📝 Step 4: Installation Wizard Walkthrough¶

Step 1: Welcome & License Verification¶

What you'll see: - Welcome message with system overview - License verification form - Product information display

What to do: 1. Enter your purchase information: - Purchase Code: Your CodeCanyon purchase code - Envato Username: Your CodeCanyon username - Domain: Your website domain (auto-filled)

Click "Verify License"
Wait for verification to complete
✅ Success: Green checkmark with "License Valid" message
❌ Error: Double-check your purchase code and username
Click "Continue" to proceed to next step

💡 Tip: Your purchase code is available in your CodeCanyon downloads section or purchase receipt email.

Step 2: System Requirements Check¶

What you'll see: - Comprehensive system requirements validation - PHP version and extensions check - File permissions verification - Server configuration review

Green Checkmarks Mean: - ✅ PHP version is compatible (8.1+) - ✅ All required PHP extensions are installed - ✅ File permissions are correctly set - ✅ Server configuration meets requirements

Red X Marks Mean: - ❌ Missing PHP extensions - ❌ Incorrect file permissions - ❌ Insufficient PHP memory limit - ❌ Other server configuration issues

If you see red X marks: 1. Contact your hosting provider to install missing PHP extensions 2. Check file permissions as described in Step 2 3. Increase PHP memory limit in hosting control panel 4. Refresh the page after making changes

Click "Continue" only when all checks show green checkmarks.

Step 3: Database Configuration¶

What you'll see: - Database connection form - Connection test button - Progress indicator for database import

Required Information: - Database Host: Usually localhost (check with hosting provider) - Database Port: Usually 3306 (default MySQL port) - Database Name: Your MySQL database name - Database Username: MySQL username with full database access - Database Password: MySQL user password

Step-by-step process:

Fill in database details

Database Host: localhost
Database Port: 3306
Database Name: your_hospital_db
Username: your_db_user
Password: your_db_password

Test connection first
Click "Test Connection" button
✅ Success: "Database connection successful!" message
❌ Error: Check credentials and database exists
Import database
Click "Continue" to start database import
Progress bar shows import status
This takes 2-5 minutes depending on server speed
Wait for completion
✅ Success: "Database imported successfully!"
❌ Error: Check database user has full permissions

🔒 Security Note: Ensure your database user has full permissions (CREATE, DROP, INSERT, UPDATE, DELETE) on the specified database.

Step 4: Administrator Account Setup¶

What you'll see: - Admin account creation form - Hospital information setup - System configuration options

Required Information: - Admin Name: Your full name (e.g., "John Smith") - Admin Email: Your email address (used for login) - Admin Password: Strong password (8+ characters) - Confirm Password: Re-enter password for verification - Admin Phone: Your contact phone number

Optional Hospital Information: - Hospital Name: Your hospital/clinic name - Hospital Address: Physical address - Hospital Phone: Main contact number - Hospital Email: General contact email

Best Practices: 1. Use a strong password: - At least 8 characters - Include uppercase, lowercase, numbers, and symbols - Example: HospitalAdmin2024!

Use a real email address:
You'll receive system notifications here
Password reset emails sent to this address
Remember these credentials:
Write them down securely
You'll need them to access the admin panel

Click "Create Admin Account" to proceed.

Step 5: System Finalization¶

What you'll see: - System optimization in progress - Cache clearing and configuration - Installation completion status

Automatic processes: 1. Cache Generation: - Configuration cache creation - Route optimization - View compilation

System Security:
Application key generation
Security settings configuration
File protection setup
Final Checks:
Database connection verification
File permission validation
System readiness confirmation

Success Message:

🎉 Installation Completed Successfully!
NewWaves Hospital Management System is ready to use.

What happens next: - Installation files are secured - System is optimized for production - Admin account is activated - You're redirected to login page

Access Your Admin Panel¶

Navigate to admin login:
URL: https://yourdomain.com/admin/login
Or click "Go to Admin Panel" from completion screen
Login with admin credentials:
Email: The admin email you created
Password: The admin password you set
First login success:
You'll see the admin dashboard
Welcome tour may appear (optional)
System statistics display

Essential First Steps¶

1. System Settings Configuration¶

Navigate to Settings → General Settings
Update hospital information
Set timezone and locale
Configure date/time formats

2. Email Configuration (Important!)¶

Go to Settings → Email Settings

Configure SMTP settings:

SMTP Host: mail.yourdomain.com
SMTP Port: 587
SMTP Username: noreply@yourdomain.com
SMTP Password: your_email_password
Encryption: TLS

Send test email to verify configuration

3. Create User Roles¶

Navigate to Users → Roles
Default roles are pre-created:
Super Admin
Admin
Doctor
Nurse
Receptionist
Customize permissions as needed

4. Set Up Departments¶

Go to Hospital → Departments
Create your hospital departments:
Cardiology
Emergency Medicine
Pediatrics
etc.
Add department descriptions and images

5. Payment Gateway Setup (Optional)¶

Navigate to Settings → Payment Settings
Configure payment gateways:
Stripe: Add API keys
PayPal: Configure client credentials
Razorpay: Add API keys (for India)
Paystack: Add keys (for Africa)

🔒 Security & Production Setup¶

Essential Security Steps¶

1. Change Default URLs (Recommended)¶

Consider changing /admin URL for security
Update .htaccess or web server configuration
Use strong, non-obvious admin URLs

2. SSL Certificate Verification¶

Ensure HTTPS is working properly
All pages should load with SSL
Mixed content warnings should be resolved

3. File Permissions Review¶

# Recommended production permissions
Folders: 755
Files: 644
Storage folder: 775 (web server writable)
Bootstrap cache: 775 (web server writable)

4. Environment Configuration¶

Verify .env file settings:

APP_ENV=production
APP_DEBUG=false
APP_URL=https://yourdomain.com

Performance Optimization¶

1. Enable Caching¶

Config Cache: Speeds up configuration loading
Route Cache: Optimizes routing performance
View Cache: Pre-compiles Blade templates

2. Database Optimization¶

Regular database maintenance
Index optimization
Query performance monitoring

🚨 Common Issues & Solutions¶

Issue 1: "Permission Denied" Errors¶

Symptoms: - Installation wizard shows file permission errors - Cannot write to storage folder - Cache clearing fails

Solutions: 1. Set correct file permissions:

chmod -R 755 storage/
chmod -R 755 bootstrap/cache/
chmod -R 755 public/uploads/

Check web server user ownership:

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

Contact hosting provider for permission assistance

Issue 2: Database Connection Failed¶

Symptoms: - "Database connection failed" error - Installation cannot proceed past database step - Connection test button shows errors

Solutions: 1. Verify database credentials: - Double-check database name - Confirm username and password - Ensure database exists

Check database permissions:
User needs full permissions (CREATE, DROP, INSERT, UPDATE, DELETE)
Try connecting with phpMyAdmin or similar tool
Verify database server:
Confirm host (usually localhost)
Check port (usually 3306)
Ensure database server is running
Contact hosting provider:
Request database setup assistance
Verify database service availability

Issue 3: "500 Internal Server Error"¶

Symptoms: - White screen or generic error page - Installation wizard doesn't load - Server returns HTTP 500 errors

Solutions: 1. Check error logs: - Review cPanel error logs - Look for specific PHP errors - Check web server error logs

Verify PHP version:
Ensure PHP 8.1+ is active
Check PHP configuration
Verify required extensions
File permissions:
Ensure proper file permissions
Check ownership settings
Verify web server access
Memory limits:
Increase PHP memory limit
Check execution time limits
Monitor resource usage

Issue 4: Installation Wizard Not Loading¶

Symptoms: - Accessing domain shows default hosting page - /install URL returns 404 error - Files uploaded but not accessible

Solutions: 1. Verify file upload: - Confirm all files uploaded completely - Check file structure is correct - Ensure no missing folders

Check domain configuration:
Verify domain points to correct folder
Confirm DNS settings
Check web server virtual host
URL rewriting:
Ensure mod_rewrite enabled (Apache)
Check .htaccess file present
Verify URL rewriting rules
Clear browser cache:
Hard refresh (Ctrl+F5)
Clear browser cache and cookies
Try different browser or incognito mode

Issue 5: Email Notifications Not Working¶

Symptoms: - Test emails not received - System notifications not sent - SMTP configuration errors

Solutions: 1. Verify SMTP settings:

SMTP Host: Correct server address
SMTP Port: 587 (TLS) or 465 (SSL)
Username: Valid email account
Password: Correct password
Encryption: TLS or SSL

Test email configuration:
Use hosting provider's SMTP settings
Try different email accounts
Check spam/junk folders
Firewall and security:
Ensure SMTP ports not blocked
Check server firewall settings
Verify hosting provider allows SMTP
Alternative solutions:
Use hosting provider's mail function
Configure SendGrid or Mailgun
Enable less secure apps (Gmail)

🎓 Post-Installation Steps¶

Getting Started Checklist¶

After successful installation, complete these steps:

[ ] Login to admin panel and explore dashboard
[ ] Configure system settings (timezone, currency, etc.)
[ ] Set up email notifications with SMTP
[ ] Create hospital departments and services
[ ] Add doctor profiles with specializations
[ ] Set up staff accounts with appropriate roles
[ ] Configure payment gateways for billing
[ ] Test patient registration and appointment booking
[ ] Review security settings and SSL configuration
[ ] Set up regular backups for data protection

Training and Documentation¶

[ ] Read the User Manual for complete feature overview
[ ] Watch tutorial videos (if available)
[ ] Test all major features with sample data
[ ] Train your staff on system usage
[ ] Set up user accounts for all staff members

Ongoing Maintenance¶

[ ] Regular system updates when available
[ ] Database backups on scheduled basis
[ ] Monitor system performance and logs
[ ] Review security settings periodically
[ ] Update payment gateway settings as needed

📞 Getting Help & Support¶

If You Need Assistance¶

Support Channels: - Email Support: support@newwavesprojects.com - CodeCanyon Comments: Ask questions on the item page - Documentation: Complete user manual included - FAQ Section: Check common questions first

When Contacting Support: 1. Include your purchase code 2. Describe the specific error you're encountering 3. Provide screenshots of any error messages 4. Include server information (PHP version, hosting provider) 5. Mention steps you've already tried

Response Times: - Critical installation issues: 2-4 hours - General questions: 24-48 hours - Feature questions: 24-48 hours

Self-Help Resources¶

User Manual: Complete system documentation
FAQ Database: Common questions and solutions
Video Tutorials: Step-by-step feature walkthroughs
Community Forum: Connect with other users
Knowledge Base: Technical articles and guides

🎉 Installation Complete!¶

Congratulations! 🎊 You have successfully installed NewWaves Hospital Management System.

Your hospital is now ready to: - Manage patients with comprehensive records - Schedule appointments with automated reminders - Process billing with multiple payment options - Maintain medical records with security compliance - Provide patient portal for self-service access - Support mobile apps with complete API

Next Steps:¶

Explore the admin dashboard to familiarize yourself
Set up your first department and doctor profiles
Create a test patient and book an appointment
Configure email notifications for better communication
Review security settings for production use

Welcome to NewWaves Hospital Management System!¶

Transform your healthcare facility with modern, efficient, and secure patient management. 🏥✨

Need help? Contact our support team at support@newwavesprojects.com

Last Updated: August 13, 2024
Version: 1.0.0
Installation Guide Version: 1.0