configuring-horizon

Install and configure Horizon in Laravel with queue monitoring and secure dashboard access.

3|1|Updated Jun 26, 2025
One-click install
npx skills add https://github.com/jasonencode/saas --skill configuring-horizon
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuring-horizon
Source: https://github.com/jasonencode/saas/tree/main/.trae/skills/configuring-horizon
Command: npx skills add https://github.com/jasonencode/saas --skill configuring-horizon

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Horizon configuration and life-cycle management in Laravel can be complex, error-prone, and time-consuming for teams integrating real-time dashboards and queue workers.

Core Features & Use Cases

  • Install Horizon and Sail integration with horizon:install and sail setup.
  • Configure config/horizon.php including supervisor blocks, queue mappings, balancing strategies, and min/max processes.
  • Implement secure dashboard access via Gate::define('viewHorizon') and troubleshoot production issues like LongWaitDetected, worker timeouts, and tagging.

Quick Start

Run Horizon install and basic configuration in a Laravel project to enable the dashboard, queue monitoring, and production-ready defaults.

Frequently Asked Questions about configuring-horizon

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I configure Laravel Horizon supervisors and queue balancing strategies?

Configure Laravel Horizon supervisors by modifying the config/horizon.php file to define supervisor blocks, queue mappings, balancing strategies, and min/max processes.

How do I secure the Horizon dashboard in a production Laravel environment?

Secure the Horizon dashboard by implementing Gate::define('viewHorizon') in your Laravel application to restrict access, ensuring only authorized users can monitor queues in production.

What is the best way to schedule Horizon snapshots for queue monitoring?

The best way to schedule Horizon snapshots is by adding the horizon:snapshot command to your Laravel scheduler, ensuring periodic queue metrics are captured for dashboard monitoring.

Why does my Laravel Horizon queue show a LongWaitDetected error in production?

A LongWaitDetected error in Horizon indicates a queue is experiencing delays exceeding configured thresholds. Troubleshoot by adjusting supervisor process counts or optimizing queue jobs in config/horizon.php.

Can I use Laravel Horizon with Sail for local queue development?

Yes, you can use Laravel Horizon with Sail by running the horizon:install and sail setup commands to integrate queue monitoring and dashboard capabilities within your local development environment.

How do I troubleshoot Horizon worker timeouts and job tagging issues?

Troubleshoot Horizon worker timeouts and job tagging by reviewing your supervisor configurations in config/horizon.php and verifying that job tags are properly defined within your Laravel queue workers.