PHPackages                             fof/horizon - PHPackages - PHPackages  [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register)

1. [Directory](/)
2. /
3. [Queues & Workers](/categories/queues)
4. /
5. fof/horizon

ActiveFlarum-extension[Queues & Workers](/categories/queues)

fof/horizon
===========

Adds Laravel Horizon to Flarum

1.0.6(2mo ago)13.0k↑15%1MITPHPPHP ^8.1CI passing

Since Feb 15Pushed 1mo ago1 watchersCompare

[ Source](https://github.com/FriendsOfFlarum/horizon)[ Packagist](https://packagist.org/packages/fof/horizon)[ Fund](https://opencollective.com/fof)[ RSS](/packages/fof-horizon/feed)WikiDiscussions 2.x Synced 1mo ago

READMEChangelog (10)Dependencies (10)Versions (19)Used By (1)

Horizon - Advanced Queue Dashboard & Management
===================================================

[](#horizon---advanced-queue-dashboard--management)

[![Laravel Horizon Dashboard](https://camo.githubusercontent.com/02bfc1ccde53ff4d83f9707bbcb398ff7bc8968e40d720cd884078f9c1b78325/68747470733a2f2f6c61726176656c2e636f6d2f696d672f646f63732f686f72697a6f6e2d6578616d706c652e706e67)](https://camo.githubusercontent.com/02bfc1ccde53ff4d83f9707bbcb398ff7bc8968e40d720cd884078f9c1b78325/68747470733a2f2f6c61726176656c2e636f6d2f696d672f646f63732f686f72697a6f6e2d6578616d706c652e706e67)

A comprehensive queue management solution for Flarum, powered by [Laravel Horizon](https://laravel.com/docs/11.x/horizon). This extension provides a beautiful dashboard for monitoring your Redis queues, along with powerful worker management and scaling capabilities.

Features
--------

[](#features)

- 📊 **Real-time Dashboard** - Beautiful web interface at `/admin/horizon`
- 🔄 **Auto-scaling Workers** - Dynamically scale workers based on queue load
- ⚖️ **Load Balancing** - Multiple balancing strategies (simple, auto, false)
- 📈 **Metrics & Insights** - Job throughput, wait times, and failure rates
- 🎯 **Job Monitoring** - Track specific jobs and tags
- 🔍 **Failed Job Management** - Retry, inspect, and clear failed jobs
- 🚦 **Supervisor Control** - Pause, continue, and terminate workers
- 📦 **Batch Job Support** - Monitor and manage job batches

Requirements
------------

[](#requirements)

- **Flarum 2.0+**
- **Redis Server** (required for Horizon to function)
- **PHP 8.2+**

Installation
------------

[](#installation)

### Step 1: Install Redis (if not already installed)

[](#step-1-install-redis-if-not-already-installed)

**On Ubuntu/Debian:**

```
sudo apt update
sudo apt install redis-server
sudo systemctl enable redis-server
sudo systemctl start redis-server
```

**On macOS (via Homebrew):**

```
brew install redis
brew services start redis
```

**Verify Redis is running:**

```
redis-cli ping
# Should return: PONG
```

### Step 2: Install the Extension

[](#step-2-install-the-extension)

```
composer require fof/horizon:"*"
php flarum cache:clear
```

This will automatically install `fof/redis` as a dependency.

Configuration
-------------

[](#configuration)

### Basic Setup

[](#basic-setup)

Horizon requires Redis to be configured. Create or modify your `extend.php` in the root of your Flarum installation:

```