Laravel

Horizon

Run Laravel Horizon as its own container with php artisan horizon. Horizon starts and supervises your Redis queue workers, so it replaces queue:work containers.

Spin Pro sets up Laravel Horizon on your own server with zero-downtime deployments.

Compose example

Horizon needs Redis. Configure the connection in your application's .env.

compose.yml

services:
  app:
    image: my-org/my-app:1.0.0
    ports:
      - "80:8080"

  horizon:
    image: my-org/my-app:1.0.0
    command: ["php", "artisan", "horizon"]
    stop_signal: SIGTERM
    healthcheck:
      test: ["CMD", "healthcheck-horizon"]
      start_period: 10s
    depends_on:
      - redis

  redis:
    image: redis:8-alpine

stop_signal and the health check are required on every worker. With SIGTERM, Horizon finishes its current jobs before it exits. Running workers explains why.

Health check

healthcheck-horizon runs php artisan horizon:status. It fails when no Horizon process is running or when Horizon is paused.

Health checks

Point the Docker health check at Laravel with one line, and check queue workers, Horizon, the scheduler, and Reverb with built-in scripts.

Nightwatch

Run the Laravel Nightwatch agent in its own Docker container and point your app at it.