Driver FixRecommendedSound, Wi-Fi or graphics acting up? Check drivers firstFind missing or outdated drivers fast.Check 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
DocumentaryTube
Admit one · Blog

How to Configure systemd to Restart a Failed FFmpeg YouTube Stream

A working systemd unit pattern for restarting failed FFmpeg YouTube streams, plus install commands, rate-limit recovery, and the limits of process restarts.
Opened Runtime4 min Written byDocumentaryTube Team
Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.

Use a systemd service with Restart=on-failure and a deliberate RestartSec= delay to relaunch FFmpeg after it exits unsuccessfully. This recovers from process failures; it does not detect every stalled stream or fix bad input, encoder settings, network problems, or YouTube ingest errors.

Create the systemd service

Create /etc/systemd/system/ffmpeg-youtube.service. This example assumes a video file that should loop; replace its paths, account, and FFmpeg arguments with those for your setup.

[Unit]
Description=FFmpeg YouTube live stream
Wants=network-online.target
After=network-online.target
StartLimitIntervalSec=300
StartLimitBurst=5

[Service]
Type=simple
User=stream
WorkingDirectory=/srv/stream
ExecStart=/usr/bin/ffmpeg -hide_banner -re -stream_loop -1 -i /srv/stream/input.mp4 -c:v libx264 -c:a aac -f flv rtmp://a.rtmp.youtube.com/live2/REPLACE_WITH_STREAM_KEY
Restart=on-failure
RestartSec=10s

[Install]
WantedBy=multi-user.target

Adjust the example safely

  • -stream_loop -1 is for a file intended to loop. For a camera, capture card, or other live input, use the appropriate FFmpeg input arguments instead.
  • Keep FFmpeg in the foreground as the ExecStart process. Do not background it from a shell; systemd needs to observe its exit.
  • Run the service as an unprivileged account with access only to the required inputs and directories. Confirm that /usr/bin/ffmpeg is the executable path on your system.
  • Replace the example stream key with your YouTube stream key. Treat it as a credential: do not commit it to a public repository or expose it in shared logs. If you use an environment file or another secret mechanism, restrict its permissions so other users cannot read it.

Restart=on-failure asks systemd to restart the service after an unsuccessful exit or other applicable failure. RestartSec=10s sets the delay before a restart. The sample StartLimitIntervalSec=300 and StartLimitBurst=5 are example guardrails against rapid restart loops, not universal settings. Automatic restarts are subject to systemd start-rate limiting; tune the values for your deployment. systemd.service documentation

Load, enable, and inspect the service

  1. After creating or editing the unit, reload systemd’s unit files:

    Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
    #1 Best Overall
    Sale
    KAMRUI Pinova P2 Mini PC, AMD Ryzen 7330U(4 Cores, 8 Threads, Up to 4.3GHz), 16GB RAM 256GB SSD, Zen3 Architecture 7nm Processor, 8MB L3 Smart Cache Mini Computers,Triple 4K Display Home/Business
    • 【AMD Ryzen 7330U】 – The Efficiency-Tuned Powerhouse,AMD Ryzen 7330U (Zen 3, SMT, 4C/8T) in KAMRUI P2 mini PC crushes rivals: Intel i3-10110U (2C/4T, 2019) and N95 (4 efficiency cores, no HT, single-channel memory). Vs predecessor Ryzen 3 4300U (4C/4T): ~50% faster single-core, ~46% multi-core, 8MB L3 cache (vs 4MB). Beats both Intel chips hugely in multi-core, making heavy multitasking, coding, data work smooth at just 15W TDP. High-end power in a cool, efficient box.
    • 【AMD Radeon Graphics】– Triple 4K Vision & Fluidity,The integrated Radeon Graphics (based on the modern Vega architecture with 6 CUs) is a visual beast, outclassing the iGPU offerings from both AMD's prior generation and Intel. The Intel UHD Graphics (i3-10110U/N95) struggles with single-channel memory and low execution units, crippling its gaming performance and barely handling basic 4K video without stuttering. While the older Radeon Vega 5 (4300U) was decent, our 7330U's Radeon Graphics (6 CUs) pushes the boundaries, delivering higher graphics clock speeds (up to 1.8GHz) and significantly better rendering capabilities. It can drive triple 4K@60Hz displays with zero lag, edit photos/videos.
    • 【Generous Storage & Easy Expansion】The KAMRUI Pinova P2 mini desktop computers comes with 16GB LPDDR4X RAM (higher frequency, lower power) for buttery‑smooth multitasking, and a 256GB M.2 SSD for blazing fast boot‑up, quick file transfers, and no more long loading screens. It also features two storage expansion slots (1x M.2 2280 SATA/NVMe PCIe 3.0 slot + 1x M.2 2280 SATA slot), supporting up to 4TB total (not included). You’ll have all the space you need for projects, media, and important data.
    • 【Triple 4K Display Output】The KAMRUI Pinova P2 mini desktop pc is equipped with HDMI 2.0 ×1 + DP 1.4 ×1 + USB 3.2 Gen2 Type‑C ×1 (with DP Alt Mode), enabling simultaneous triple 4K@60Hz output. Whether for home entertainment, remote work, or conference room presentations, it delivers an immersive visual experience. Two USB 3.2 Gen2 Type‑A ports (up to 10Gbps – 21x faster than USB 2.0) make data transfers and device expansion a breeze.
    • 【USB 3.2 Gen2 Type‑C: 10Gbps & Versatile Connectivity】The USB 3.2 Gen2 Type‑C port on the KAMRUI P2 small pc supports 10Gbps data transfer speeds and can also output DisplayPort 1.4 video. Together with Gigabit LAN, Wi‑Fi, and Bluetooth, you get a fast, flexible, and productive connected environment – wired or wireless.
    sudo systemctl daemon-reload
  2. Enable the service at boot and start it now:

    sudo systemctl enable --now ffmpeg-youtube.service
  3. Check its current state and follow its logs:

    systemctl status ffmpeg-youtube.service
    journalctl -u ffmpeg-youtube.service -f
  4. After later unit-file edits, run sudo systemctl daemon-reload again, then restart the service:

    sudo systemctl restart ffmpeg-youtube.service

Know what systemd can—and cannot—recover

When FFmpeg exits

Systemd can restart FFmpeg when the service process exits unsuccessfully, is terminated abnormally, or meets applicable timeout or watchdog failure conditions. RestartSec provides a pause, while the start-rate limit prevents unlimited rapid retries. If repeated attempts exceed that limit, automatic starts can stop until the underlying problem is addressed. systemd.unit documentation

Rank #2
GMKtec M5 Ultra Gaming Mini PC Ryzen 7 7730U 32GB RAM 512GB SSD Desktop
  • Office Gaming Mini PC - UPGRADED GMKtec Nucbox M5 Ultra Series is equipped with the powerful AMD Ryzen 7 7730U processor, 8 Cores/16 Threads, Base 2.00GHz (Power Saving Quiet Mode) with Turbo Boost up to 4.50GHz (Performance Mode) in BIOS settings, Based on the ZEN 3+ architecture, this small but powerful mini pc delivers satisfying results in productivity, office work, and gaming. 35% Performance increase over AMD Ryzen 5 7430U/ Ryzen 7 5700U, 5600U, 5560U, 5500U.
  • 32GB DDR4 RAM & 512GB PCIe SSD - Installed with DDR4 32GB RAM Dual Channel (2x16GB), the Nucbox M5 Plus mini pc support expansion to 64GB RAM. Featured with 512GB M.2 2280 PCIe 3.0 SSD, support dual slot expansion to 4TB SSD. (Upgrades not included)
  • DUAL NIC LAN 2.5G RJ45 - Fast Network Speeds: Enjoy up to 2500Mbps data transmission speed without worrying about lagging. Ideal for working, gaming, and surfing the internet. Great for Untangle, Pfsense or as a server office PC.
  • Mini Desktop Computer with 4K Triple Screen Display - Nucbox M5 Ultra integrates AMD Radeon Graphics 8 Cores 2000 MHz GPU to deliver powerful graphics processing power to easily handle the demands of complex design software, 4K@60Hz UHD video editing, and playback. It can connect to 3 display screens simultaneously.
  • Fast Internet WiFi 6E + BT5.2 Connection - GMKtec Mini PC with WiFi-6E Wireless, have 2.5G/5G/6G triple band, more faster and lower latency. Bluetooth 5.2 allowing you more quickly to connect other wireless devices (headset, mouse, keyboard, etc.) Interface features 2*USB3.2 ports, 2*USB2.0 ports, 1*HDMI 2.0 port(4K@60Hz), 1*USB-C port(PD/DP/DATA), 1*DP Port, 1*Audio 3.5mm (HP&MIC), 1*DC Power Port.

When FFmpeg stays alive but the stream is broken

A running process is not proof that YouTube is receiving useful media. Restart=on-failure does not detect every stalled output or ingest-side problem. Check FFmpeg’s output and YouTube Live Control Room’s stream health. YouTube advises testing before going live and monitoring stream health during the event: “Make sure to test before you start your live stream.” YouTube Help: Choose live encoder settings, bitrates, and resolutions

Choose encoder quality your connection can reliably sustain. Restarting the process alone will not correct an unsuitable encoder configuration, an unstable connection, or a YouTube ingest problem.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
BOSGAME E5 11 Pro Mini PC, AMD Ryzen 5300U 4C/ 8T, Business Home Office PC
  • 【AMD Ryzen 3 5300U CPU: Outperforms N150 & 3500U】 BOSGAME E5 mini PC is powered by the TSMC 7nm FinFET architecture AMD Ryzen 3 5300U processor (4 Cores, 8 Threads, up to 3.8GHz boost, 6MB total cache). Compared to low-end Intel N150 or 3500U chips which only have 4 single threads and throttle under load, the 5300U delivers over 30% faster multi-core speed. Run 30+ browser tabs, large Excel sheets, and Zoom meetings simultaneously without system lag.
  • 【8GB DDR4 RAM & 256GB NVMe SSD Storage】 Installed with high-speed 8GB DDR4 dual-channel memory and a fast 256GB M.2 2280 SSD, eliminating slow boot times and application loading delays. To accommodate growing data requirements, the upgradeable hardware design features dual SODIMM slots that allow you to expand memory up to 64GB RAM, ensuring smooth operation during heavy multitasking.
  • 【High-Capacity Dual M.2 SSD Storage Expansion】 Never worry about running out of space for your business files. In addition to the pre-installed 256GB system drive, the motherboard houses an extra empty internal M.2 2280 NVMe PCIe 3.0 slot. This allows you to easily add a second solid-state drive for up to an additional 2TB of storage capacity (upgrades not included) without needing to remove or reinstall the original operating system.
  • 【Radeon 6-Core Graphics & Triple 4K Displays】 Integrated with official AMD Radeon Graphics (6 Graphics Cores, 1500 MHz frequency) for casual gaming, photo editing, and crisp 4K media decoding. Featuring 1x HDMI 2.0 port, 1x DisplayPort, and 1x Full-Function Type-C port, the E5 outputs true 4K@60Hz resolution to three monitors at once. This multi-screen setup eliminates constant window-switching for traders, programmers, and office workers.
  • 【Dual 2.5GbE LAN Ports for Advanced Networking】 Experience fast wired network transmission speeds up to 2500Mbps without lagging or buffering. The integration of dual 2.5 Gigabit Ethernet ports (powered by Realtek RTL8125 controller) makes this compact computer an exceptional hardware choice for tech enthusiasts. Easily configure it into software routers, hardware firewalls (pfSense, OpnSense), home NAS servers, or local homelabs.

Systemd restart versus FFmpeg output recovery

These are separate recovery layers. Systemd relaunches the entire FFmpeg process after a qualifying failure. FFmpeg also documents output-side recovery features, including recovery options in its FIFO muxer for supported network-output cases. Their suitability depends on the muxer and output configuration; check the documentation for your installed FFmpeg version before adding options. FFmpeg formats documentation

Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Troubleshoot a service that will not stay live

  • The service fails immediately: Run systemctl status ffmpeg-youtube.service and inspect journalctl -u ffmpeg-youtube.service. Check the FFmpeg error, executable and input paths, account permissions, network availability, and stream-key validity.
  • It keeps restarting and then stops: Read the logs to find the original failure and systemd’s restart decisions. Fix the cause before clearing the rate limit; otherwise it may fail again in the same way.
  • It is rate-limited or shows failed: After investigating and correcting the cause, clear the recorded failure state and counters, then start it again:
    sudo systemctl reset-failed ffmpeg-youtube.service
    sudo systemctl start ffmpeg-youtube.service

    reset-failed clears the failed state and resets restart and start-rate-limit counters; it does not repair the underlying error. systemctl documentation

  • FFmpeg is active but YouTube reports a problem: Check FFmpeg output, ingest connectivity, encoder configuration, and YouTube stream health. Test the setup before relying on it for an event.

Or let it run in the cloud

For a prerecorded video or playlist intended to run continuously on YouTube, StreamNeo is an alternative to maintaining a systemd host: upload the video, add your YouTube stream key, and go live. Nothing has to stay on at home; it plays your upload rather than broadcasting a camera. Any quality up to 4K 60fps streams as uploaded at one flat price per slot, with no re-encode or quality tiers. It automatically recovers if YouTube drops the stream. The first day is free with no card, one free day per account. Monthly pricing is $9.99 per month. UPI and cards are accepted in India; card checkout is available worldwide. Learn about StreamNeo or start your free day.

Rank #4
Sale
GMKtec G3S Mini PC Intel N95 Processor (Up to 3.4GHz) 8GB RAM 256GB M.2 SSD
  • 12th Intel Alder Lake N95 Processor – The GMKtec G3 S Mini PC is powered by the 12th Gen Intel N95 processor with 4 cores, 4 threads, 6MB cache and a burst frequency up to 3.4GHz. Compared with N100/N5105/N5100/N5095, the N95 delivers up to 36% overall performance improvement. Perfect for routine tasks, office work, and home entertainment, this compact mini desktop is more convenient than traditional bulky PCs.
  • 8GB RAM & 256GB SSD Storage – Pre-installed with 8GB DDR4 memory and a fast 256GB M.2 2242 SSD, the G3 S mini desktop offers quicker startup, smoother multitasking, and faster file transfers. Enjoy seamless performance whether you’re working on multiple applications, browsing, or streaming content.
  • Rich Interfaces & Connectivity – The G3 S mini computer comes equipped with USB 3.2 (up to 10Gbps), dual HDMI 2.0 (4K@60Hz), and a 3.5mm audio jack. With support for WiFi 5, Bluetooth 5.0, and Gigabit Ethernet (RJ45 1000MbE), it connects easily with monitors, projectors, printers, office equipment, and other peripherals, making it versatile for both home and business use.
  • Dual 4K Display Support – Featuring upgraded Intel UHD Graphics (up to 1000MHz), the G3 S supports 4K video playback and AV1 decoding for a smooth viewing experience. With dual HDMI outputs, you can connect two 4K@60Hz displays simultaneously, enabling efficient multitasking for work and entertainment.
  • GMKtec WARRANTY - GMKtec offers a 1-year limited GMKtec's warranty for each mini PC, starting from the date of the purchase. All defects due to design and workmanship are covered. With a professional after sales team always ready to attend to your needs, you can simply relax and enjoy your mini PC.

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 Screening Room

  1. How to Migrate a 24/7 YouTube Stream to a New VPSAdmit one · BlogHow to Migrate a 24/7 YouTube Stream to a New VPSOpened04 OCT 2026Runtime6 min
  2. How to Run a YouTube Playlist on a Headless Linux Server—and Broadcast It LiveAdmit one · BlogHow to Run a YouTube Playlist on a Headless Linux Server-and Broadcast It LiveOpened04 OCT 2026Runtime6 min
  3. How to Make a 24/7 Indian Music YouTube Stream Restart After a Server RebootAdmit one · BlogHow to Make a 24/7 Indian Music YouTube Stream Restart After a Server RebootOpened04 OCT 2026Runtime6 min
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.