configuring-horizon

Configure Laravel Horizon supervisors, queues, and dashboard authorization.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/gabriel-daldegan/missionary_journal --skill configuring-horizon-gabriel-daldegan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: configuring-horizon
Source: https://github.com/gabriel-daldegan/missionary_journal/tree/main/.agents/skills/configuring-horizon
Command: npx skills add https://github.com/gabriel-daldegan/missionary_journal --skill configuring-horizon-gabriel-daldegan

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Configure and troubleshoot Laravel Horizon installations and dashboards.

Core Features & Use Cases

  • Install Horizon and Sail integration (horizon:install, Sail setup)
  • Configure config/horizon.php (supervisor blocks, queue assignments, balancing strategies, minProcesses/maxProcesses)
  • Fix the dashboard (authorization via Gate::define viewHorizon, blank metrics, horizon:snapshot scheduling)
  • Troubleshoot production issues (worker crashes, timeout chain ordering, LongWaitDetected notifications, waits config)
  • Job tagging and silencing

Quick Start

Install Horizon with horizon:install and Sail, configure config/horizon.php, and verify the Horizon dashboard is accessible.

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?▼

Configure Laravel Horizon supervisors and queue balancing by defining supervisor blocks, queue assignments, and balancing strategies with minProcesses and maxProcesses in the config/horizon.php file. This setup manages worker distribution across queues.

Why is my Laravel Horizon dashboard showing blank metrics?▼

Laravel Horizon dashboard metrics appear blank when horizon:snapshot scheduling is not configured. You must schedule the snapshot command in your application's task scheduler to continuously populate the metrics data.

How do I authorize access to the Laravel Horizon dashboard in production?▼

Authorize access to the Laravel Horizon dashboard by defining a Gate::define viewHorizon rule in your application. This gate restricts dashboard visibility to approved users, securing production queue monitoring.

How do I resolve LongWaitDetected notifications and worker crashes in Horizon?▼

Resolve LongWaitDetected notifications and worker crashes by adjusting the waits config in config/horizon.php and correcting timeout chain ordering. This prevents long queue wait thresholds from triggering false alerts.

Can I tag and silence specific jobs in Laravel Horizon?▼

Yes, you can tag and silence specific jobs in Laravel Horizon. Job tagging allows you to monitor specific job categories in the dashboard, while silencing suppresses notifications for non-critical tasks.

Does Laravel Horizon work with Sail for local queue monitoring?▼

Yes, Laravel Horizon works with Sail for local queue monitoring. You can install Horizon using horizon:install and configure Sail integration to run supervisors alongside your local development environment.