configuring-horizon

Configure Laravel Horizon supervisors, balancing, notifications, and security settings.

1|Updated Apr 9, 2026
One-click install
npx skills add https://github.com/italokandrade/ai-dev --skill configuring-horizon-italokandrade
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuring-horizon
Source: https://github.com/italokandrade/ai-dev/tree/main/ai-dev-core/.claude/skills/configuring-horizon
Command: npx skills add https://github.com/italokandrade/ai-dev --skill configuring-horizon-italokandrade

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill streamlines the configuration, management, and troubleshooting of Laravel Horizon, reducing setup errors and operational downtime.

Core Features & Use Cases

  • Horizon Installation & Setup: Guides through installing Horizon with Laravel Sail and initial configuration.
  • Supervisor & Load Balancing Configuration: Assists in defining supervisors, balancing strategies, and environment-specific settings.
  • Dashboard & Notifications: Supports setting up access controls, notifications for long waits, and job tagging.
  • Troubleshooting Production Issues: Helps identify common pitfalls like metric data gaps, Redis driver limitations, and worker timeout misconfigurations.
  • Use Case: An administrator wants to configure Horizon for a production environment with auto-scaling supervisors and secure dashboard access, then verify the setup.

Quick Start

Use the configuring-horizon skill to set up supervisor blocks and define dashboard authorization in your Laravel project.

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 for a production environment?

Configure Laravel Horizon supervisors by defining supervisor blocks, selecting balancing strategies, and applying environment-specific settings to optimize queue management. This ensures proper worker distribution and reliable job processing in production.

Why does Laravel Horizon show metric data gaps and missing dashboard stats?

Metric data gaps in Laravel Horizon typically stem from Redis driver limitations or misconfigured worker timeouts. Troubleshooting these production issues involves verifying your Redis linkage, checking environment-specific settings, and ensuring supervisor configurations match your queue workload demands.

How do I secure the Laravel Horizon dashboard and set up access controls?

Securing the Laravel Horizon dashboard requires defining dashboard authorization rules within your application's Horizon service provider. You can configure access controls to restrict visibility to authorized administrators and set up notifications for long queue waits.

Can I use Laravel Horizon with Laravel Sail for initial queue setup?

Yes, you can install and configure Laravel Horizon using Laravel Sail for initial setup. The process guides you through linking Horizon components with Redis and establishing the foundational queue management environment for your local development workflow.

What balancing strategies are available when setting up Laravel Horizon queues?

Laravel Horizon supports multiple balancing strategies for queue distribution across workers. Configuring these strategies within your supervisor blocks allows you to optimize job throughput based on your specific production workload and auto-scaling requirements.

How do I fix Laravel Horizon worker timeout misconfigurations?

Fixing Laravel Horizon worker timeouts involves adjusting the timeout settings within your supervisor configurations to match your job execution limits. Troubleshooting this requires verifying environment-specific settings and ensuring proper Redis driver linkage to prevent unexpected job termination.