🚀 Travel Management System
Installation Guide
📋 Quick Overview: This guide will help you install the Travel Management System using our easy-to-use web installer. The entire process takes just a few minutes!
📋 System Requirements
- PHP: 8.1 or higher
- Database: MySQL 5.7+ or MariaDB 10.3+
- Web Server: Apache 2.4+ or Nginx 1.15+
- Extensions: BCMath, Ctype, Fileinfo, JSON, Mbstring, OpenSSL, PDO, Tokenizer, XML, ZIP
- Memory: 512MB RAM minimum (1GB recommended)
- Storage: 1GB free disk space
🚀 Quick Installation (Recommended)
Step 1: Server Setup
Ensure your web server meets the system requirements and has PHP and MySQL/MariaDB installed and running.
Step 2: Upload Files
Upload all application files to your web server's document root (e.g., public_html, www, or htdocs).
Step 3: Set Permissions
Ensure the web server has write permissions to these directories:
# Linux/macOS
chmod -R 755 storage bootstrap/cache
chown -R www-data:www-data storage bootstrap/cache
# Windows (run as administrator)
icacls storage /grant IIS_IUSRS:F /T
icacls bootstrap\cache /grant IIS_IUSRS:F /T
Step 4: Access Web Installer
Open your web browser and navigate to:
http://your-domain.com/installer
The web installer will automatically handle all dependencies and guide you through the complete setup process.
🔧 Web Installer Process
Database Configuration
The installer will prompt you to enter your database details:
- Database Host: Usually
localhost or 127.0.0.1
- Database Name: Create an empty database beforehand
- Username & Password: Database user credentials
- Port: Usually
3306 for MySQL
Installation Options
During the migration step, you'll be presented with two options:
- Install without dummy data: Clean installation with no sample data
- Install with dummy data: Includes sample data and a default admin account
🔑 Default Admin Credentials (if dummy data selected)
Email: [email protected]
Password: password
⚠️ Change these credentials immediately after first login!
✅ Post-Installation
System Access
- URL:
http://your-domain.com/login
- The installer automatically redirects you to the login page after completion
Initial Configuration
- Update admin password and profile information
- Configure company settings and branding
- Set up user roles and permissions
- Add initial data (airlines, airports, etc.)
- Configure email settings for notifications
- Set up backup procedures
🔒 Security Recommendations
- Remove installer files after successful installation
- Enable HTTPS for production environments
- Configure proper file permissions
- Set up regular database backups
- Update default passwords for all accounts
- Ensure
.env file is not accessible via web browser
🔧 Manual Installation (Advanced Users Only)
Note: This section is for developers and system administrators only. Regular users should use the web installer above.
# 1. Install dependencies (developers only)
composer install --no-dev --optimize-autoloader
# 2. Copy environment file
cp .env.example .env
# 3. Generate application key
php artisan key:generate
# 4. Configure database in .env file
# Edit DB_HOST, DB_DATABASE, DB_USERNAME, DB_PASSWORD
# 5. Run migrations
php artisan migrate --force
# 6. Seed database (optional)
php artisan db:seed --force
# 7. Mark as installed
touch storage/installed
🛠️ Troubleshooting
Common Issues
Web Installer Issues
- Installer not accessible: Ensure the
installed file doesn't exist in storage/ directory
- Permission errors: Check that web server has write permissions to
storage/ and bootstrap/cache/
- Blank installer page: Verify all dependencies are installed with
composer install
- Database connection fails: Double-check database credentials and ensure database server is running
Installation Errors
- Migration fails: Ensure database user has CREATE, ALTER, DROP privileges
- Seeder errors: Check if dummy data option conflicts with existing data
- Timeout issues: Increase PHP execution time limit in
php.ini
Manual Recovery
If the web installer fails, you can complete installation manually:
php artisan migrate --force
php artisan db:seed --force # Optional: for dummy data
touch storage/installed # Mark as installed
📞 Support
If you encounter any issues during installation:
- Web Installer Issues: Check browser console for JavaScript errors and server logs for PHP errors
- Database Problems: Verify database credentials and user permissions
- Permission Errors: Ensure web server has proper write access to required directories
- Review Logs: Check Laravel logs in
storage/logs/laravel.log for detailed error information
- Contact Support: Provide detailed error messages, system information, and installation steps attempted
🎉 Installation Complete!
Congratulations! Your Travel Management System is now ready to use. Remember to change default passwords and configure your system settings.
📚 Credits & Acknowledgments
This Travel Management System is built using several excellent open-source frameworks and libraries:
Core Frameworks
Frontend Libraries
Additional Components
License Information: All third-party libraries are used in accordance with their respective open-source licenses. We extend our gratitude to the developers and maintainers of these excellent tools that make this system possible.