configuring-horizon

Configure Laravel Horizon supervisors, dashboard access, and snapshot scheduling.

1.5k|170|Updated Sep 25, 2024
One-click install
npx skills add https://github.com/relaticle/relaticle --skill configuring-horizon-relaticle
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: configuring-horizon
Source: https://github.com/relaticle/relaticle/tree/main/.claude/skills/configuring-horizon
Command: npx skills add https://github.com/relaticle/relaticle --skill configuring-horizon-relaticle

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Horizon configuration guides you through installing and configuring Laravel Horizon, setting up supervision, and securing access to the dashboard to stabilize queue processing in production.

Core Features & Use Cases

  • Install Horizon: horizon:install and basic Sail setup for local development.
  • Configure supervisors: merge defaults with environment-specific overrides in config/horizon.php.
  • Dashboard security: define access controls to restrict horizon visibility to authorized users.
  • Monitoring & troubleshooting: ensure horizon:snapshot scheduling for metrics and handle common production issues like worker crashes and timeouts.

Quick Start

Install Horizon, set up a supervisor in config/horizon.php, and verify the dashboard access and snapshot scheduling to start managing queue workers.

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 different environments?

Configure Laravel Horizon supervisors by merging default settings with environment-specific overrides in the config/horizon.php file. This allows you to define separate supervisor configurations for local, staging, and production deployments to stabilize queue processing.

How do I secure the Horizon dashboard in production?

Secure the Horizon dashboard by defining a Gate::define for viewHorizon in your application. This restricts dashboard visibility and access to authorized users only, preventing unauthorized monitoring of your queue workers.

Why are my Horizon metrics empty or not updating?

Horizon metrics remain empty without a scheduled horizon:snapshot command. You must add this task to your scheduler to capture and produce meaningful metrics data for monitoring queue performance over time.

What is the best way to install Horizon for local development?

Install Horizon by running the horizon:install Artisan command. For local development, you can utilize Laravel Sail to set up the required Redis dependencies and start managing queue workers immediately.

Can I use Horizon to manage Redis queue worker crashes and timeouts in production?

Yes, Horizon manages Redis queue workers and helps handle common production issues like worker crashes and timeouts. Configuring supervisors in config/horizon.php ensures stable operation and automatic process recovery.