configuring-horizon

Configure Laravel Horizon supervisors, dashboard security, metrics, and notifications.

3|Updated Jan 26, 2025
One-click install
npx skills add https://github.com/michaelnabil230/laravel-starter-kit --skill configuring-horizon-michaelnabil230
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuring-horizon
Source: https://github.com/michaelnabil230/laravel-starter-kit/tree/main/.agents/skills/configuring-horizon
Command: npx skills add https://github.com/michaelnabil230/laravel-starter-kit --skill configuring-horizon-michaelnabil230

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill helps you configure and troubleshoot Laravel Horizon with confidence, reducing the friction of setting up queue workers, dashboard access, and production monitoring.

Core Features & Use Cases

  • Installation Guidance: Covers Horizon installation paths such as the standard setup flow and Laravel Sail-based setup.
  • Supervisor Configuration: Explains how to define supervisors, assign queues, and tune balancing, scaling, and timeout behavior.
  • Dashboard and Metrics Support: Helps secure the Horizon dashboard, diagnose blank metrics, and ensure snapshot scheduling is in place.
  • Notifications and Queue Tuning: Provides guidance for long-wait alerts, notification routing, tagging, silencing, and production queue troubleshooting.
  • Use Case: A Laravel team can use this Skill to set up Horizon for a new application, secure the dashboard for admins, and resolve issues like missing metrics or worker crashes without guesswork.

Quick Start

Use this skill to review your Laravel Horizon setup, apply the recommended configuration for supervisors, dashboard authorization, metrics, and notifications, and then verify that your queue workers behave correctly in the target environment.

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

To configure Laravel Horizon supervisors, define them in the Horizon configuration file to assign specific queues and tune balancing, scaling, and timeout behavior for your production environment.

Why are my Laravel Horizon dashboard metrics showing blank data?

Blank Laravel Horizon dashboard metrics typically occur when scheduled snapshot collection is missing or misconfigured. You must ensure the metrics snapshot command is properly scheduled to capture and display queue analytics data.

How do I secure the Laravel Horizon dashboard in production?

Securing the Laravel Horizon dashboard requires configuring dashboard authorization gates within your application's HorizonServiceProvider. This restricts dashboard access to authorized admins only in production environments.

Do I need Redis to run Laravel Horizon for queue processing?

Yes, Laravel Horizon requires Redis queue support to run. It is built specifically to manage Redis-backed queues, relying on Redis for supervisor coordination, job processing, and metrics snapshot collection.

What is the best way to set up Laravel Horizon notifications for long queue waits?

Setting up Laravel Horizon notifications involves configuring long-wait alerts, routing notifications to appropriate channels, and applying tagging or silencing rules within Horizon's configuration file to effectively monitor production queue behavior.

How do I install Laravel Horizon using Laravel Sail?

Installing Laravel Horizon via Laravel Sail follows a specific setup flow that integrates with the local Docker environment. You apply standard Horizon installation paths adapted for Sail to configure queue workers and dashboard access.