configuring-horizon

Configure and troubleshoot Laravel Horizon for background job processing.

15|3|Updated Feb 10, 2026
One-click install
npx skills add https://github.com/signals-rental/framework --skill configuring-horizon-signals-rental
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuring-horizon
Source: https://github.com/signals-rental/framework/tree/main/.claude/skills/configuring-horizon
Command: npx skills add https://github.com/signals-rental/framework --skill configuring-horizon-signals-rental

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Guides Laravel developers to install, configure, and troubleshoot Laravel Horizon to ensure reliable background job processing and accurate metrics.

Core Features & Use Cases

  • Install Horizon and Sail integration: includes horizon:install and Sail setup for local development.
  • Configure supervision and queues: edit config/horizon.php to define defaults and environment-specific overrides.
  • Secure access & monitoring: enforce dashboard access with Gate::define viewHorizon and schedule horizon:snapshot for metrics.
  • Troubleshooting guidance: cover common issues like worker crashes, timeout ordering, LongWaitDetected alerts, and tag/silencing strategies.

Quick Start

Install Horizon in your Laravel project with php artisan horizon:install and view the /horizon dashboard to confirm a working setup.

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 supervisor blocks for environment-specific queue management?

Laravel Horizon supervisor blocks are configured in the config/horizon.php file, where you define default worker settings and environment-specific overrides. This ensures reliable background job processing by tailoring queue management configurations to local or production contexts.

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

Secure Laravel Horizon dashboard access by implementing a Gate::define viewHorizon authorization rule. This restricts the /horizon monitoring dashboard to authorized personnel, preventing unauthorized access to background job metrics and queue management data.

Why are my Laravel Horizon metrics and dashboard data not updating?

Laravel Horizon metrics may not update if the horizon:snapshot command is not scheduled. Schedule the horizon:snapshot Artisan command via Laravel's task scheduler to periodically capture queue metrics and ensure the dashboard displays accurate recent job data.

How do I fix Laravel Horizon worker crashes and LongWaitDetected alerts?

Fix Laravel Horizon worker crashes and LongWaitDetected alerts by reviewing supervisor configurations in config/horizon.php for timeout limits and queue priorities. Adjust worker counts and timeout settings, or use tag silencing strategies to manage noisy queue alerts.

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

Yes, Laravel Horizon works with Sail for local queue development by running the horizon:install command within the Sail environment. This allows developers to monitor background jobs and test queue configurations locally before deploying to production.

What is the best way to handle Laravel Horizon job processing failures?

The best way to handle Laravel Horizon job processing failures is to utilize troubleshooting guidance for common issues like worker crashes and timeout ordering. Configure supervisor blocks in config/horizon.php and monitor LongWaitDetected alerts to proactively manage queue failures.