Externa ships Laravel Horizon for Redis-backed queues (zip, duplicate, imports, webhooks). Use it when Redis is available; otherwise keep QUEUE_CONNECTION=database and queue:listen / queue:work.

Upstream

Laravel Horizon 13.x · Redis: Redis prerequisite · Jobs: Operations · UI: Dashboard

What Externa does

Item	Detail
Package	`laravel/horizon`
Config	`config/horizon.php`
Provider	`App\Providers\HorizonServiceProvider`
Primary UI	Dashboard Health tab — native status / pending / failed / throughput / workloads
Advanced UI	`/horizon` (super-admin deep dive; no primary “Open Horizon” CTA on Health)
Gate	`viewHorizon` — super-admin (`EffectivePermissionResolver::isSuperAdmin`)

Env / commands

QUEUE_CONNECTION=redis
REDIS_CLIENT=phpredis
REDIS_HOST=127.0.0.1
REDIS_PORT=6379

# Prefer PHP 8.4 (Herd)
php84 artisan horizon

With Herd Redis + Herd Reverb already up, pair Horizon with pulse:work (see Minimal vs full stack). Standalone all-in-one: composer run dev:full (also starts reverb:start — skip that process if Herd Reverb owns :8080).

Graceful restart after deploy: php artisan horizon:terminate.

Supervisor (production)

Run php artisan horizon under Supervisor/systemd (not queue:work when Horizon is the chosen worker). See Horizon — deploying.

Fail / retry UI

Queue health appears on the Inertia dashboard Health tab. Open /horizon as a super-admin only when you need deep job inspection, failures, and retries. The Inertia admin Jobs page remains a separate app-level monitor (CanShowJobs) over jobs / failed_jobs.

Super-admins with viewHorizon can also navigate to /horizon from Settings → Performance (/settings/performance) — the Observability section shows quick links when permitted. See Operations.