# Queue Setup

The queue allows your application to run time consuming tasks in the background. While setting up a queue is optional, we highly recommend enabling it whenever possible.

### Importance of queue

When a quiz is assigned to a team, a notification email is sent to each member. For large teams, this can be time-consuming and may cause “request timed out” errors if it exceeds the PHP script’s maximum execution time. There are two solutions for this.

* Increase php script execution time.
* Setting up a queue

### Increase PHP Script Execution Time

To set up a Laravel queue in production, you first need to configure a queue driver in your `.env` file, such as `redis` or `database`, by setting `QUEUE_CONNECTION=redis` (or your chosen driver). Next, ensure your queue worker is running continuously in the background to process jobs. This is typically done using a process supervisor like **Supervisor** on Linux. Create a Supervisor configuration file for your Laravel queue worker, specifying the command `php /path-to-your-project/artisan queue:work --sleep=3 --tries=3`. Then, start and enable the Supervisor service to ensure the queue worker runs automatically on system boot. Finally, monitor the worker logs regularly to catch any failed jobs and ensure smooth operation of background tasks.

### Setup Queue 

To set up a Laravel queue in production, you first need to configure a queue driver in your `.env` file, such as `redis` or `database`, by setting `QUEUE_CONNECTION=redis` (or your chosen driver). Next, ensure your queue worker is running continuously in the background to process jobs. This is typically done using a process supervisor like **Supervisor** on Linux. Create a Supervisor configuration file for your Laravel queue worker, specifying the command `php /path-to-your-project/artisan queue:work --sleep=3 --tries=3`. Then, start and enable the Supervisor service to ensure the queue worker runs automatically on system boot. Finally, monitor the worker logs regularly to catch any failed jobs and ensure smooth operation of background tasks.

1. **Choose a Queue Driver**
   * Edit your `.env` file and set `QUEUE_CONNECTION=database` (simplest for shared hosting) or `redis` if your host supports it.
2. **Run the Queue Worker**
   * On cPanel, you don’t have access to `Supervisor`, but you can use **Cron Jobs** to run the queue worker periodically.
   * In cPanel, go to **Cron Jobs** → **Add New Cron Job**.
   * Use a command like:

     ```bash
     /usr/local/bin/php /home/username/your-project/artisan queue:work --sleep=3 --tries=3
     ```

     * Adjust the path to your PHP binary and Laravel project.
     * Set the cron to run every minute (or a frequency suitable for your needs).
3. **Monitor Failed Jobs**
   * Make sure to run `php artisan queue:failed` and `php artisan queue:retry all` occasionally, either via cron or manually.
   * You can also log outputs to a file by appending `>> /home/username/queue.log 2>&1` to the cron command.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://lakm.gitbook.io/evaluator/installation/queue-setup.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.