Skip to content

Installation Guide ​

Quizora includes a visual web installer β€” a step-by-step wizard that guides you through the entire setup process. You do not need to use the command line.


Step 1 β€” Upload the Files ​

  1. Download the Quizora zip from your CodeCanyon account.
  2. Extract the zip file on your computer.
  3. Upload the contents of the quizora/ folder to your web server.
    • If using cPanel: Upload via the File Manager or FTP, placing files in public_html/ (or your desired subdomain folder).
    • If using VPS: Upload to /var/www/quizora/ or your preferred path.
  4. Make sure the web root points to the public/ folder inside Quizora.
How to point the web root to public/ (cPanel)

In cPanel, go to Domains β†’ Create a Domain (or edit an existing subdomain). Set the Document Root field to public_html/quizora/public rather than public_html/quizora.

How to point the web root to public/ (Nginx)

In your Nginx server block, set:

nginx
root /var/www/quizora/public;

Then reload Nginx: sudo nginx -s reload


Step 2 β€” Create a Database ​

  1. Log in to your hosting panel (cPanel, Plesk, phpMyAdmin, etc.).
  2. Create a new MySQL database.
  3. Create a database user and assign it full permissions on the new database.
  4. Note down: database name, database username, database password, and host (usually localhost).

Step 3 β€” Run the Installer ​

  1. Visit your website URL in a browser β€” e.g. https://yourdomain.com.
  2. You'll be automatically redirected to the installer: https://yourdomain.com/install.
  3. Follow the 6-step wizard:

Installer Step 1: Requirements Check ​

System Requirements Check

The installer checks that your server meets all PHP extension and folder permission requirements. Every item must show PASS before you can continue. Common fixes:

  • Folder not writable: Set permissions on storage/ and bootstrap/cache/ to 755 or 775.
  • Missing PHP extension: Enable it in your hosting panel's PHP configuration (PHP Selector or php.ini).

Redis shows WARN, not FAIL

Redis is recommended for AI streaming and background job queues, but the platform will still run without it (it falls back to database queues). You can add Redis later.

Installer Step 2: Database Configuration ​

Database Configuration Step

Enter the database credentials from Step 2 above. Click Test Connection β€” a green confirmation appears when the connection succeeds. Fix any errors before clicking Continue.

Installer Step 3: Application Setup ​

Application Setup

Fill in:

  • App Name β€” The name of your platform (e.g. "My Quiz Hub"). Shown in the browser title and emails.
  • App URL β€” Your website's full URL (e.g. https://yourdomain.com). Must match exactly.
  • Full Name β€” Your super-admin display name.
  • Email Address β€” Your super-admin login email.
  • Password β€” Your super-admin login password (min 8 characters).
  • Install sample data β€” Toggle on to pre-populate the platform with demo categories, quizzes, and users. Recommended for first-time evaluation.

Installer Step 4: Ready to Install ​

Ready to Install

Review the configuration summary. If everything looks correct, click Install Now. The installer will:

  • Run all database migrations (creates every table)
  • Seed default categories and subscription plans
  • Create your super-admin account
  • Generate your application encryption key
  • Lock the installer so it cannot be re-run accidentally

Do not navigate away during installation

The install process takes 10–30 seconds. Leaving the page mid-install may leave the database in a partial state.


Step 4 β€” Log In ​

After installation completes, click Go to Admin Panel and log in with the email and password you set in Installer Step 3.

First Login Checklist

Once logged in, go to Admin β†’ Settings and complete:

  1. Upload your platform logo
  2. Set your commission rate
  3. Pick an AI provider under AI (OpenAI, Claude, Gemini, Groq, free self-hosted Ollama… or Offline) and click Test connection. See AI Configuration
  4. Add your Razorpay or Stripe keys (to accept quiz payments)
  5. Configure SMTP mail settings (for result and receipt emails)

Step 5 β€” Background Jobs (required) ​

Quizora sends some work to a queue so students don't wait for it: quiz sales (the creator's earnings and the platform commission), result and receipt emails, PDF certificates and AI study advice. Something on the server has to process that queue. Until it does, these jobs wait: students get no result email and no certificate, and paid orders aren't credited to creators.

You need two things:

WhatWhy
A queue worker that runs all the timeProcesses sales, emails, certificates and AI advice
A cron job every minuteSubscription expiry, quiz statistics and the weekly digest

Replace /path/to/quizora below with the folder you uploaded Quizora to (the one that contains artisan).

List every queue

Quizora uses four queues. The worker must be started with --queue=payments,emails,payouts,default. A plain php artisan queue:work only reads default, so sales and emails would never be processed.

On a VPS (Supervisor) ​

Add the cron job with crontab -e:

bash
* * * * * cd /path/to/quizora && php artisan schedule:run >> /dev/null 2>&1

Then keep a worker running with Supervisor. Create /etc/supervisor/conf.d/quizora.conf:

ini
[program:quizora-worker]
command=php /path/to/quizora/artisan queue:work --queue=payments,emails,payouts,default --sleep=3 --tries=3 --timeout=120 --max-time=3600
user=www-data
autostart=true
autorestart=true
stopwaitsecs=130
redirect_stderr=true
stdout_logfile=/path/to/quizora/storage/logs/worker.log
bash
sudo supervisorctl reread && sudo supervisorctl update

Use the user your web server runs as (www-data on Ubuntu and Debian; nginx or apache on some other systems). The included Docker setup already runs a worker, so skip this step if you use it.

On shared hosting (cPanel, DirectAdmin, Plesk) ​

Shared hosting has no Supervisor, so start the worker from cron instead. In cPanel β†’ Cron Jobs (DirectAdmin: Cron Jobs, Plesk: Scheduled Tasks), add these two jobs, both set to run every minute:

bash
cd /path/to/quizora && php artisan schedule:run >> /dev/null 2>&1
bash
cd /path/to/quizora && flock -n storage/framework/queue.lock php artisan queue:work --queue=payments,emails,payouts,default --tries=3 --timeout=120 --max-time=3500 >> /dev/null 2>&1

flock -n makes sure only one worker runs at a time: every minute cron tries to start one and gives up straight away if one is already running. --max-time=3500 restarts the worker about once an hour, so it picks up new code and stays within hosting limits.

On cPanel the path usually looks like /home/youruser/quizora or /home/youruser/public_html/quizora. If plain php is an older version on your host, use the full path to PHP 8.3, for example /opt/cpanel/ea-php83/root/usr/bin/php on cPanel. Your host can tell you the right path.

Free setup help

Not sure? Open a ticket at helpdesk.ishalabs.com and we'll set up both jobs with you on cPanel or DirectAdmin.

Check that it works ​

Take a quiz as a student and check that student's inbox for the result email. From the command line you can also count waiting jobs:

bash
php artisan queue:monitor payments,emails,payouts,default

If jobs keep piling up, the worker isn't running: check the cron job's path and PHP version. Jobs that failed (for example because the SMTP settings are wrong) are listed by php artisan queue:failed and can be retried with php artisan queue:retry all.

After every update

Run php artisan queue:restart after updating Quizora, by one click or by hand, so the worker loads the new code straight away. Otherwise it picks it up within the hour, when --max-time restarts it.


Updating Quizora ​

The easiest way is one-click updates from Admin β†’ Configuration β†’ License & Updates β€” see License & Updates.

To update manually instead, when a new version is available on CodeCanyon:

  1. Download the updated zip from your CodeCanyon account.
  2. Back up your current installation (export the database + download your storage/app/ folder).
  3. Replace the application files β€” do not overwrite your .env file.
  4. Run php artisan migrate from the root folder.

Always back up first

Before updating, export your database and download a copy of your storage/app/ folder. Updates should be smooth, but a backup protects your data.

Quizora v1.5.1 β€” AI-Powered Quiz Platform