Hardware FixRecommendedDevice not working? Your driver may be the problemCheck updates for common hardware issues.Fix DriversOctober DealsAmazon USOctober deal check: compare before you payAmazon US: current deals, useful picks and tech finds.Check DealsClean PCRecommendedOne scan can reveal what keeps slowing WindowsLook for cleanup and repair opportunities.Run Scan×
Skip to content
World desk3 min

Laravel Queue Worker SIGTERM on Deploy: How to Restart Safely

Laravel workers finish an active job after SIGTERM when allowed to do so. Use queue:restart and a process monitor for a standard self-managed deployment, and align job, retry, and shutdown limits.
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Laravel queue workers can finish the job they are processing after receiving SIGTERM, then exit. For a standard self-managed deployment, deploy the new code, run php artisan queue:restart, and let a process monitor replace the workers. Laravel 13.31 adds connection and queue details to the WorkerStopping event when a worker is killed; it is not the release that introduced graceful signal handling.

What SIGTERM does to a Laravel queue worker

A queue worker is a long-lived process: it keeps the application code it loaded at startup. Laravel’s current 13.x queue documentation says a worker that receives SIGQUIT, SIGTERM, or SIGINT while processing a job finishes that job before exiting. That is a graceful stop request, not a promise that the job will finish if the host or container forcibly kills the process before its shutdown allowance runs out. Laravel queue documentation

As an Amazon Associate I earn from qualifying purchases.

Because an exiting worker does not automatically become a new process, a process monitor such as Supervisor must start a replacement. The replacement starts against the deployed code; the old worker does not switch code in place.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Gracefully restart workers during a self-managed deployment

  1. Deploy the new application code. Workers already running continue with the code loaded when they started.
  2. Run php artisan queue:restart in the application’s deployment context. Laravel writes a restart signal to the cache. Workers check that signal and exit after their current job rather than taking another one.
  3. Let the process monitor replace each exiting worker. Confirm that the monitor is configured to keep the desired workers running.
  4. Check cache visibility. The command and workers need to use a working cache configuration that lets them see the same restart signal. A process-local or otherwise unsuitable cache can keep workers from observing it.
  5. Align shutdown and retry settings. Check job duration, worker timeout, queue retry timing, and the host or orchestrator’s SIGTERM grace period together.

Laravel documents the restart command and cache-based signal in its queue guide. The exact time a platform grants a process to exit is platform-specific; inspect the relevant host or orchestrator settings rather than assuming Laravel controls that interval.

#1 Best Overall
Tecmojo 12U Open Frame Network Rack for IT & AV Gear, AV Rack Floor Standing or Wall Mounted,with 2 PCS 1U Rack Shelves & Mounting Hardware,Network Rack for 19" Networking,Audio and Video Device
  • 【Powerful Load-bearing】12U Network Rack Open Frame is constructed from durable cold rolled steel; Rack shelf supports enhance stability, wall-mounted capacity of 130lbs, the ground-mounted up to 260lbs
  • 【Considerate Designs】Open-frame layout, including a top panel adding space, anti-slip shelf stops fixing devices and compatible racks for stack and expansion to meet requirements of home server rack
  • 【Complete Accessories】A 12U open frame server rack, two ventilated shelves, four shelf stops, four velcro straps and a set of equipment mounting screws
  • 【Versatile Application】Ideal for space-efficient multi-device setups in warehouses, retail, classrooms, offices and more; Excellent choices as AV Rack/IT Rack
  • 【Effortless Setup】 Network Rack includes hardware, a comprehensive manual, mounting hole drilling template and an online assembly video to simplify setup

Choose the stop mechanism that fits the deployment

queue:restart for queue workers

This is Laravel’s queue-worker restart path. It coordinates through the application’s cache and causes workers to leave after their current job. Use it when you want Laravel workers to pick up deployed code, and ensure a process monitor brings them back.

php artisan reload for reloadable services

Laravel’s deployment documentation describes php artisan reload as a way to terminate reloadable long-running services when a deployment is managed outside Laravel Cloud. Laravel Cloud handles graceful service reloads automatically. These deployment paths are distinct from sending an infrastructure-level SIGTERM directly to a process. See Laravel’s deployment documentation.

Rank #2
Sale
StarTech 42U 4-Post Open Frame Rack, 19in, 22-40in, 1323lb/600kg
  • ADJUSTABLE DEPTH: 4-Post 42U open frame server rack with 4 vertical rails and adjustable mounting depth 22" to 40" (56,0cm to 101,7cm); Compatible with various servers / switches / data / AV and other IT equipment; EIA/ECA-310-E Compliant
  • EASY ASSEMBLY: Mobile network rack with easy-to-follow assembly instructions and online video; Compact flat-pack shipping to avoid damage and facilitate installation; Total product height of 80.3in (204 cm) with casters, 78in (198cm) without casters
  • COLD ROLLED STEEL: Durable 4 Post 19in open frame rack designed for ventilation with 42U mounting height and 1320lb (600kg) weight capacity (stationary); 3 install options included: casters, levelling feet, or base-plate to secure rack to the floor
  • HARDWARE INCLUDED: Rolling computer/data rack includes cage nuts and screws to mount equipment, easy to read Units (U) and depth adjustment markings, cable management hooks for organization, and required assembly tools
  • THE IT PRO'S CHOICE: Designed and built for IT Professionals, this 42U rack is backed for 2-years, including free lifetime 24/5 multi-lingual technical assistance

Platform-sent SIGTERM

A host or orchestrator may send SIGTERM as part of its shutdown or deployment policy, but whether it does so and how long it waits before forceful termination depends on that platform. Laravel’s graceful behavior applies only while the process is allowed to run.

Free tools Windows power users keep installed

One-click scans. No signup required.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Give long-running jobs a chance to stop cleanly

Ordinary jobs can finish their active work before the worker exits. For work such as a long import, a job may need to stop fetching records or persist progress before shutdown. Laravel provides the IlluminateContractsQueueInterruptible contract for this job-level response. Implement the contract and define interrupted; Laravel passes the received signal number to that method. Laravel queue documentation

Rank #3
VEVOR 12U Open Frame Server Rack, 23-40 in Adjustable Depth, Free Standing or Wall Mount Network Server Rack, 4 Post AV Rack with Casters, Holds All Your Networking IT Equipment AV Gear Router Modem
  • Adjustable Depth: 23-40'' adjustable depth is used for servers and network equipment, ensuring enough space for AV equipment, components, and cabling, while allowing you to access ports and equipment from multiple sides.
  • Strong Load Capacity: Ground-Mounted Load Capacity: 500 lbs, Wall-Mounted Load Capacity: 150 lbs. The av rack is made of carbon steel for better weldability performance and can help save space while meeting your need to place multiple devices.
  • User-friendly Design: Ergonomic design makes the open frame av rack easier to use. The additional top panel is able to place other items with more available space. Roller design moves anywhere and anytime, is convenient, and is more energy-saving.
  • Complete Accessories: We provide the accessories you need, including 2 x Pallets, 145 x M5*10 Cross Head Screws, 4 x Casters, 4 x M10*50 Expansion Screws,10 x M6*12 Cage Nuts, 1 x Grounding Wire, 1 x User Manual.
  • Wide Application: The server rack wall mount maximizes the use of available space, suitable for retail venues, classrooms, offices, and other places where space is limited.

Use that hook to make progress safe across retries—for example, persist progress in a way that can be resumed without corrupting or duplicating work. It is an opportunity to respond to interruption, not an unlimited shutdown guarantee: the platform can still terminate the process when its grace period expires.

Keep timeout and retry timing compatible

Laravel documents a default worker --timeout of 60 seconds, but that default is not automatically right for every job. The queue guide says to set --timeout several seconds shorter than retry_after. If the retry interval expires while a job is still running, the queue may make that job available again and it could run twice. For Amazon SQS, use the queue’s visibility timeout as the corresponding retry control. Laravel queue documentation

Rank #4
AxcessAbles 12U Network Rack with Wheels - 500lb Capacity, 18" Depth | 19-Inch Open Frame AV Rack Case with 3” Caster Wheels | Screws, Spacer, Tool Included
  • Universal 19” Rack Mount Compatibility – Perfect for pro audio, video, IT, and network gear. Compatible with mixers, routers, patch panels, servers, power amps, and more.
  • Heavy-Duty Load Capacity – Built to support up to 550 lbs. Ideal for studio gear, DJ setups, server equipment, and AV components that demand serious stability.
  • Robust Steel Frame & Design – Made with 1.5mm thick steel and weighs 36 lbs for maximum durability, reduced vibration, and long-term reliability in any setting.
  • Mobile & Secure – Preinstalled with 3” industrial-grade caster wheels (lockable), making it easy to move and position your rack exactly where you need it.
  • All-In-One Setup Kit Included – Comes with 34 rack screws (5mm & 6mm), a 1U blank spacer, and an assembly tool—ready for fast installation out of the box.

Choose values based on the expected job duration and your connection’s configuration. Where duplicate execution would cause harm, make the job idempotent so repeating it does not repeat its effects.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

What changed in Laravel 13.31

The Laravel Framework changelog lists v13.31.0 on September 8, 2026. Its specific queue-related change adds connection and queue information to the WorkerStopping event when a worker is killed. This improves the context available to code handling that event; it should not be confused with the existing documented behavior for graceful termination signals or with the Interruptible job contract. Check the installed patch version before relying on the added event details. Laravel release notes Laravel Framework changelog

Best Value
VEVOR 9U Open Frame Server Rack, 23''-40'' Adjustable Depth, Free Standing or Wall Mount Network Server Rack, 4 Post AV Rack with Casters, Holds All Your Networking IT Equipment AV Gear Router Modem
  • Adjustable Depth: Depth adjustable from 23" to 40", this open frame server rack accommodates servers and network equipment while providing ample space for A/V gears and cable management. Enjoy easy access to ports and devices from multiple angles.
  • High Weight Capacity: Supports up to 300 lbs on the floor (200 lbs when adjusted to maximum depth) and 200 lbs when wall-mounted (depth cannot be adjusted in wall-mounted mode). Made from carbon steel for superior welding performance and durability, this open frame rack is designed to save space while accommodating multiple devices.
  • User-Friendly Design: Designed with your convenience in mind, this open frame server rack features an top shelf for extra storage and improved space utilization. The rolling casters let you move it effortlessly wherever you need it, making setup and movement a breeze.
  • Widely Applicable: Maximize your space with this adaptable open frame server rack, designed to make the most of every inch. Ideal for retail spots, classrooms, offices, and any area where space is at a premium, it delivers practical solutions for your storage needs.
  • Everything You Need: Our open-frame rack comes with fully equipped accessory kit for easy setup and secure installation: 2 x Trays, 4 x Casters, 1 x set of Screws, 16 x M6*12 Cage Nuts, 1 x Grounding Wire, 1 x Internal & External Hex Wrenches, and 1 x User Manual.

Product prices and availability are accurate as of the date/time indicated and are subject to change. Any price and availability information displayed on Amazon at the time of purchase will apply.

Leave a Reply

Your email address will not be published. Required fields are marked *

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

More from the Wire

  1. World desk4 min
    How to Spot an AI Voice Scam Before Sending MoneyDon’t rely on how a caller sounds. Pause, call back through a known number, and verify the emergency with another trusted person before sending money.
  2. Mountain View desk4 min
    Google’s SynthID Detector: How to Check AI-Generated Images, Video and AudioGoogle’s SynthID Detector looks for an embedded watermark in supported images, video and audio. Here is what its results do—and do not—show.
  3. Redmond desk20 min
    How to create a link to File or Folder in Windows 11Windows 11 gives you several ways to point to a file or folder without moving or duplicating it. You can create a desktop shortcut,…
Recommended PC Tool
Recommended PC Tool
Windows Errors? Fix Them Before They SpreadFree repair scan
Outdated Drivers Are Slowing You DownFree scan - exact matches

Two free Windows tools

One Free Minute Could Fix That PC

Before you go - each of these free tools takes about a minute and tackles what quietly slows a Windows PC down.

Special offer. View Outbyte info, uninstall instructions, EULA, and Privacy Policy.