Troubleshooting

This section covers installation, server, and admin panel issues for the Digital HR System. Following these steps will help resolve most common problems.

1. Database Connection Error

❌ Error:

SQLSTATE[HY000] [1045] Access denied for user
SQLSTATE[HY000] [2002] Connection refused

✅ Solution:

1. Open the .env file.

2. Update database credentials correctly:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=your_database_name
DB_USERNAME=your_database_user
DB_PASSWORD=your_database_password

1. Run:

php artisan config:clear
php artisan cache:clear

1. Make sure:

   • Database exists.

   • User has full privileges.

   • Hosting supports MySQL.

2. 500 Internal Server Error

❌ Possible Causes:

• Incorrect .env configuration

• PHP version mismatch

• Missing vendor folder

• File permission issues

✅ Solution:

1. Ensure PHP version is 8.2.

2. Run:

composer install

1. Set correct permissions:

chmod -R 775 storage
chmod -R 775 bootstrap/cache

1. Check logs at storage/logs/laravel.log.

---

3. “No Application Encryption Key Has Been Specified”

❌ Error:

No application encryption key has been specified.

✅ Solution:

php artisan key:generate
php artisan config:clear

---

4. Blank Page After Installation

❌ Possible Causes:

• Wrong document root

• Mod_rewrite disabled

• Missing .htaccess

✅ Solution:

1. Set domain root to /public.

2. Enable mod_rewrite (Apache).

3. Ensure .htaccess exists in public.

---

5. Firebase Web Push Not Working

❌ Possible Causes:

• Incorrect Firebase json file in storage folder

✅ Solution:

1. Verify Firebase file or generate a new one and replace with existing one.

6. Emails Not Sending

❌ Possible Causes:

• SMTP not configured

• Wrong credentials

✅ Solution:

MAIL_MAILER=smtp
MAIL_HOST=smtp.mailtrap.io
MAIL_PORT=587
MAIL_USERNAME=your_username
MAIL_PASSWORD=your_password
MAIL_ENCRYPTION=tls
MAIL_FROM_ADDRESS=[e-mail]

Then run:

php artisan config:clear

7. Cron Jobs Not Working

❌ Issue:

Scheduled tasks not running.

✅ Solution:

Add cron job:

* * * * * php /path-to-project/artisan schedule:run >> /dev/null 2>&1

8. Composer Not Found (Shared Hosting)

❌ Error:

composer: command not found

✅ Solution:

• Run composer locally and upload vendor folder.

• Or request SSH access and Composer from hosting.

9. Login Not Working / Session Expired

❌ Possible Causes:

• APP_URL mismatch

• HTTPS/HTTP conflict

• SESSION_DRIVER misconfigured

✅ Solution:

APP_URL=https://yourdomain.com
SESSION_DRIVER=file
php artisan config:clear
php artisan cache:clear

---

10. Admin Login Failed / Username or Password Incorrect

❌ Causes:

• Wrong credentials

• Caps Lock on

• Database mismatch

✅ Solution:

• Reset password via “Forgot Password”.

• Verify admin exists in employee or users or front desk menu

11. User Role or Permission Issues

❌ Issue:

• Admin cannot access menus

• Users see pages they shouldn’t

✅ Solution:

• Check roles & permissions in admin panel.

• Verify roles, permissions, role_user.

• Clear cache:

12. Payroll Calculation Errors

✅ Solution:

• Verify employee salary, allowances, deductions.

• Re-run payroll calculation.

---

13. User Cannot Reset Password

✅ Solution:

• Verify SMTP in .env.

• Clear cache:

php artisan config:clear