configuring-horizon

Configure Laravel Horizon supervisors, queues, and dashboard authorization.

1|Updated Apr 30, 2026
One-click install
npx skills add https://github.com/jonaaix/laravel-livewire-base --skill configuring-horizon-jonaaix
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuring-horizon
Source: https://github.com/jonaaix/laravel-livewire-base/tree/main/.claude/skills/configuring-horizon
Command: npx skills add https://github.com/jonaaix/laravel-livewire-base --skill configuring-horizon-jonaaix

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Horizon configuration and management is challenging across development, staging, and production. This skill provides a structured approach to installing Horizon, integrating Sail, configuring config/horizon.php (supervisor blocks, queue assignments, balancing strategies, min/max processes), securing the dashboard via Gate::define viewHorizon, enabling horizon:snapshot scheduling for metrics, and troubleshooting production issues like worker crashes and long waits.

Core Features & Use Cases

  • Install Horizon with horizon:install and Sail integration for Laravel projects.
  • Configure supervisors, queues, balancing, and metrics in config/horizon.php.
  • Troubleshoot common production issues including worker crashes, timeout chains, and LongWaitDetected notifications.

Quick Start

Install Horizon, configure the default supervisor, and verify that the dashboard is accessible with restricted access.

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 queues for production?

Securing the Horizon dashboard requires defining a Gate::define viewHorizon rule in your application. This restricts dashboard access to authorized users only, preventing unauthorized exposure of queue metrics and job details in production environments.

How do I install Laravel Horizon using Sail?

Installing Laravel Horizon with Sail integration requires running the horizon:install command. This sets up the default configuration file, publishes assets, and prepares your local development environment for queue management.

Why do my Horizon queue workers crash or trigger LongWaitDetected notifications?

Horizon worker crashes and LongWaitDetected notifications often stem from misconfigured timeout chains or insufficient supervisor processes. Troubleshooting involves adjusting balancing strategies, verifying queue assignments, and ensuring process limits match your workload in config/horizon.php.

How do I schedule Horizon snapshots for metrics tracking?

Scheduling Horizon snapshots requires adding the horizon:snapshot command to your scheduled tasks. This captures queue metrics over time, enabling you to monitor throughput and job performance through the Horizon dashboard.

Does Laravel Horizon work with both Redis and database queues?

Horizon is designed for Laravel projects using Redis queues for robust queue processing. While it integrates with Redis for managing supervisor blocks and metrics, standard database queues are also part of the broader Laravel queue ecosystem.