Skip to main content

Troubleshooting

If you encounter issues while using ZenTutor Pro, refer to the solutions below.

Installation Issues​

The installation wizard is not loading​

  • Ensure your server meets the minimum requirements:
    ✅ PHP 8.1+
    ✅ MySQL 5.7+ or MariaDB 10+
    ✅ Composer and Node.js installed
  • Check if your .env file is correctly configured.
  • Run php artisan config:clear and php artisan cache:clear to refresh settings.
  • Make sure storage, bootstrap/cache, and public/uploads have write permissions.

Database migration failed​

  • Check if your database connection is correctly set in .env:
  DB_CONNECTION=mysql
  DB_HOST=127.0.0.1
  DB_PORT=3306
  DB_DATABASE=your_database
  DB_USERNAME=your_username
  DB_PASSWORD=your_password

Run php artisan migrate --seed again. If an error occurs, check the logs in storage/logs/laravel.log

Zoom & Meeting Issues​

Zoom meetings are not starting​

  • Ensure your Zoom API Key and Secret are set correctly in .env.
  • Check if your Zoom JWT app or OAuth app is active.
  • If using Server-to-Server OAuth, verify that permissions are granted.
  • Run php artisan config:clear to refresh settings.

I cannot join a Zoom meeting from within the app​

  • Ensure your Meeting SDK settings are configured correctly.
  • If using embedded Zoom, check your CORS settings.
  • Try opening the meeting link in a separate browser tab to debug.

Video Playback Issues​

My uploaded videos are not playing​

  • Ensure the correct video type is selected: YouTube, Vimeo, MP4, Bunny.net.
  • If using Bunny.net, confirm the correct Video ID is entered instead of a URL.
  • Check if secure streaming is enabled in the Admin Panel.
  • If using an MP4 file, make sure the file path is correct.

YouTube/Vimeo videos are not displaying​

  • Ensure you are entering a valid YouTube/Vimeo video URL.
  • Some videos may have restricted embedding; try another video.
  • Check if any browser extensions (ad blockers) are blocking the player.

Payment & Enrollment Issues​

Student payments are not getting approved​

  • Make sure the Admin has reviewed and approved the payment receipt.
  • Check if the payment entry was generated for the month in the Admin panel.
  • Ensure the student's enrollment is active.

A student cannot access a paid course​

  • Verify that the payment has been approved by the Admin.
  • If it's a live course, check if the subscription is still active.
  • If it's a video course, ensure the student has a valid one-time payment.

User Management Issues​

An account is blocked, how can I unblock it?​

  • Admins can unblock users from Admin Panel → Users → Select User → Unblock.
  • If the user was blocked for failed payments, ensure payments are updated.

I cannot log in as an Admin​

  • Ensure you are using the correct Admin credentials.

  • Try resetting your password via Forgot Password.

  • If you are locked out, manually create an admin user by running:

    php artisan tinker
    Then enter:
    \App\Models\User::create([
        'name' => 'Admin',
        'email' => 'admin@example.com',
        'password' => bcrypt('admin123'),
        'role' => '1'
    ]);

  • Run php artisan cache:clear after making changes.

Other Common Issues​

My changes are not reflecting​

  • Run the following commands to clear caches: 
    php artisan cache:clear
    php artisan config:clear
    php artisan view:clear
    php artisan route:clear
  • If you are changing the front end inertia react code use 
    npm run dev

The app is slow or unresponsive​

  • Optimize the app with: 
    php artisan optimize
  • Enable queue workers if using background jobs: 
    php artisan queue:work
  • Make sure your server has sufficient resources (RAM, CPU, storage).

We keep this page updated when new issues are reported by users. If your issue is not listed here, feel free to send us an email at support@adhithi.co.uk