Laravel Horizon Setup

Transcribed Jun 14, 2026 Watch on YouTube ↗

Intermediate 2 min read For: Laravel developers familiar with Docker and queue systems who want to set up Horizon for monitoring.

2.0K

Views

42

Likes

0

Comments

0

Dislikes

2.1%

📈 Moderate

AI Summary

This tutorial demonstrates how to set up Laravel Horizon in a Docker environment using a pre-made template. The process involves modifying the Docker Compose file, installing the PCNTL extension, installing Horizon via Composer, and configuring it to monitor queues. The video also shows how to create a test job and verify that Horizon is working correctly through its dashboard.

Chapters

1 Introduction and Template Overview 0:00 2 Modifying Docker Compose and Dockerfile 0:30 3 Installing Horizon 1:02 4 Configuration and Test Job 1:32 5 Building Containers and Testing 2:32

[0:00]

Introduction and Template

The presenter introduces a Docker template with Laravel, queue worker, Nginx, database, and Redis, which simplifies the Horizon setup.

[0:30]

Modify Docker Compose

Rename the queue worker service to 'horizon' and change the start command from 'queue:work' to 'horizon'.

[0:47]

Install PCNTL Extension

Add the PCNTL PHP extension to the Dockerfile, as it is required by Horizon.

[1:02]

Install Horizon via Composer

Run 'composer require laravel/horizon' inside the backend directory, then 'php artisan horizon:install' to publish configuration and assets.

[1:32]

Horizon Configuration

The config/horizon.php file allows setting supervisors, processes, memory limits, queue balancing strategies, etc.

[1:54]

Create a Test Job

Create a ProcessPodcast job that logs output, and add a route to dispatch the job.

[2:32]

Environment Variables

Ensure .env has correct Redis host, password, and port (use service name for Docker, localhost for local).

[2:53]

Build and Run Containers

Run 'docker compose up --build -d' to build and start containers.

[3:00]

Access Horizon Dashboard

Visit /horizon to see the dashboard showing active processes, metrics, batches, pending and completed jobs.

[3:18]

Test the Queue

Hit the route multiple times to dispatch jobs; verify they appear as completed in the dashboard.

Setting up Laravel Horizon in Docker is straightforward: modify the Docker Compose file, install PCNTL and Horizon, configure the service, and use the dashboard to monitor queues. The presenter encourages viewers to like the video to help others avoid overpriced templates.

Clickbait Check

95% Legit

"The title accurately describes the video content; it's a straightforward setup guide for Laravel Horizon."

Mentioned in this Video

Docker template

link

Tutorial Checklist

1 0:30 In docker-compose.yml, rename the queue worker service to 'horizon' and change the command to 'php artisan horizon'.

2 0:47 In the Dockerfile, add the PCNTL extension (e.g., RUN docker-php-ext-install pcntl).

3 1:02 Run 'composer require laravel/horizon' inside the backend directory.

4 1:25 Run 'php artisan horizon:install' to publish configuration and assets.

5 1:54 Create a test job (e.g., ProcessPodcast) that logs output.

6 2:17 Add a route to dispatch the job (e.g., Route::get('/process', fn() => ProcessPodcast::dispatch()).

7 2:32 Update .env with Redis host, password, and port (use service name for Docker).

8 2:53 Run 'docker compose up --build -d' to build and start containers.

9 3:00 Access /horizon to view the dashboard and monitor jobs.

Study Flashcards (7)

What PHP extension is required by Laravel Horizon?

easy Click to reveal answer

PCNTL