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.