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

To update a current Restreamer v2 Docker installation while protecting its settings, back up the host directory mounted to /core/config, preserve the existing Docker configuration and mounts, pull the desired image, and restart the container with those same settings. Then verify the YouTube destination in Restreamer before your next broadcast. Restreamer documents persistence and specific migration paths, but does not guarantee that every YouTube credential or destination setting survives every upgrade.

Before updating: identify your version and preserve your setup

Restreamer’s update instructions differ for current v2 installations and legacy v0.6.x installations. Check the installed version first; do not apply the short v2 update procedure to a v0.6.x container. The official update instructions recommend using the latest datarhei Restreamer, but the correct path depends on your starting version.

Record the Docker configuration

Keep the actual Docker run command or Compose configuration used for your deployment. Note the image name and variant, port mappings, environment variables, and host paths. The update procedure assumes you will restart using the usual Docker invocation for your installation; replacing it with a generic command can omit settings specific to your setup. Restreamer documents its Docker configuration and mounts in its Docker installation guide.

Back up persistent state

For v2, the documented container paths are /core/config for configuration and state, and /core/data for persistent internal files. Make a separate copy of the host directory mounted to /core/config before changing the container. Consider copying the host directory mounted to /core/data as well. Ensure the backup is separate from the live directories, so a mistaken replacement or removal does not affect both.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
#1 Best Overall
Elebase USB to USB C Adapter for iPhone 18 Pro Max,USBC Car Charger Adapter
  • Read Before You Buy — No Video Output: These adapters support charging and USB 2.0 data transfer, but cannot transmit video signals. Except for standard USB webcams (which use USB data only), they are not compatible with HDMI/DisplayPort cables, video-capable USB-C hubs, or docking stations with video output.
  • Convert USB-A Ports to USB-C: Designed to connect USB-C earphones, cables, flash drives, card readers, and other USB-C accessories to standard USB-A ports. Plug-and-play with no drivers or software required.
  • Aluminum Alloy Housing: Built with a sturdy aluminum alloy shell that aids in heat dissipation and protects against daily wear and scratches. Designed to maintain a stable and secure connection.
  • Compact & Travel-Friendly: The ultra-compact design allows the adapter to stay plugged into your device without blocking adjacent ports or adding bulk, reducing wear and tear on your original USB ports.
  • 12-Month Warranty: Backed by a 12-month manufacturer warranty for peace of mind. Designed to meet strict quality control standards for reliable everyday performance.

You can also export the database from System settings in expert mode. Restreamer documents database export in its system settings guide. Treat the export as an additional safeguard, not a substitute for retaining the correct host mounts.

Update an existing Restreamer v2 Docker installation

  1. Confirm the version and mounts. Verify that this is a v2 installation and identify the host directories mapped to /core/config and /core/data. Check that they contain the state you expect.
  2. Make and verify a backup. Copy the host-mounted configuration directory to a separate location. Back up the data directory if it contains files you need, and export the database from expert-mode System settings if available.
  3. Pull the desired current image. Use the image and variant appropriate to your installation. Preserve choices such as a cuda variant rather than switching variants without a reason. The official update page says to pull the current Docker image before restarting.
  4. Recreate or restart with the same configuration. Retain the existing port mappings and settings, and map the same host paths to /core/config and /core/data. Do not accidentally point the new container at an empty host directory: the container’s internal paths alone do not preserve state if the host mounts are missing or changed.
  5. Verify Restreamer and YouTube before going live. Open Restreamer’s stream settings and confirm the saved destination and stream configuration. Check the YouTube destination as well, then test the setup before the next broadcast. Restreamer’s stream settings manual describes the active stream configuration area; it does not establish a universal guarantee that all YouTube credentials and settings survive every update path.

Migrating a legacy v0.6.x installation to v2

A v0.6.x installation needs the documented migration route, not just a v2 image pull. Restreamer’s migration guide says to upgrade through v0.6.8 first; it warns that skipping that version may result in lost settings. Adapt the paths below to your host deployment rather than copying them blindly.

Rank #2
Anker USB-C Hub, 5-in-1 USB Hub for Laptops, 4K HDMI Multiport Adapter
  • 5-in-1 USB-C Hub: Experience comprehensive connectivity featuring a Power Delivery input, two USB-A 2.0 ports, a USB-A 3.0 port, and an HDMI port. (Note: The USB-C power delivery input port is only for connecting an external wall charger to power your laptop and cannot power peripheral devices.)
  • 90W Pass-Through Charging: Achieve optimal charging with 90W pass-through power to your laptop, supported by a total input of 100W, with the hub reserving 10W for operational efficiency. (Note: Wall charger not included.)
  • Quick Data Transfers: Accelerate your productivity with rapid data transfers using a high-speed 5Gbps USB 3.0 port and two 480Mbps USB 2.0 ports.
  • 4K HDMI Display: Enhance your visual experience with a hub capable of delivering 4K resolution at 30Hz in both mirror and extend modes. Please note that this hub is compatible with MacBook (macOS 12 and newer), Windows 10 and 11, ChromeOS, and laptops equipped with DP Alt Mode and Power Delivery. Note: This device is not compatible with Linux.
  • What You Get: Anker USB-C Hub (5-in-1, 4K HDMI), welcome guide, 18-month warranty, and our friendly customer service.
  1. Back up the existing configuration. Keep a separate copy of the directory currently mounted at /restreamer/db, along with the deployment configuration and any needed data.
  2. Upgrade the legacy installation to v0.6.8. Start v0.6.8 and stream from the video source, as directed by the migration guide.
  3. Stop and remove the v0.6.8 container. Retain the host data and configuration directories; removing a container should not mean deleting the files you need to migrate.
  4. Pull the v2 image and adjust the mounts. Change the old configuration mount from /mnt/restreamer/db:/restreamer/db to /mnt/restreamer/db:/core/config, and add a data mount such as /opt/restreamer/data:/core/data. These are guide examples: use the actual host paths for your installation.
  5. Start v2 and check the import. The guide says the first v2 startup imports the settings and creates new db.json and config.json files in the mounted configuration directory. It also says legacy RS_ environment values are transferred on first v2 startup and may then be removed.
  6. Verify the YouTube destination and stream. Inspect the resulting configuration in Restreamer and confirm the YouTube destination before broadcasting. Do not assume a successful settings import proves that every YouTube credential is usable.

What to verify before the next YouTube broadcast

  • The container is using the intended image and variant, with the expected ports and environment settings.
  • The host directories are still mounted to /core/config and /core/data; Restreamer starts with the expected saved state.
  • The stream settings and YouTube destination are present and correct. If a credential is missing or rejected, restore or re-enter it before starting the broadcast.
  • The stream can be started and appears as expected in YouTube. Resolve any destination or connection issue before relying on the updated installation for a live session.

Rollback limits for Restreamer 2.4.0 and later

Rollback is not a universal safety net. Restreamer’s migration guide says FFmpeg 5.1.2 in versions 2.4.0 and later is incompatible with earlier versions. It describes a limited route involving database file renaming and an older image such as 2.3.0, but warns that processes created with 2.4.0 or newer cannot be restored by that route. Consult the guide for the exact situation before attempting a downgrade; keep the separate backup so you can recover files without treating this narrow procedure as a general rollback recipe.

Common update problems and fixes

Restreamer starts with missing or default settings

The new container may not have the original host directory mounted to /core/config, or may be pointed to a different, empty directory. Stop and compare the new mount configuration with the one recorded before the update. Restore the correct host path rather than rebuilding settings over an uncertain state.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Rank #3
Sale
Anker USB C Hub, 7in1 Multi-Port USB Adapter, 4K@60Hz USBC to HDMI Splitter
  • Sleek 7-in-1 USB-C Hub: Features an HDMI port, two USB-A 3.0 ports, and a USB-C data port, each providing 5Gbps transfer speeds. It also includes a USB-C PD input port for charging up to 100W and dual SD and TF card slots, all in a compact design.
  • Flawless 4K@60Hz Video with HDMI: Delivers exceptional clarity and smoothness with its 4K@60Hz HDMI port, making it ideal for high-definition presentations and entertainment. (Note: Only the HDMI port supports video projection; the USB-C port is for data transfer only.)
  • Double Up on Efficiency: The two USB-A 3.0 ports and a USB-C port support a fast 5Gbps data rate, significantly boosting your transfer speeds and improving productivity.
  • Fast and Reliable 85W Charging: Offers high-capacity, speedy charging for laptops up to 85W, so you spend less time tethered to an outlet and more time being productive.
  • What You Get: Anker USB-C Hub (7-in-1), welcome guide, 18-month warranty, and our friendly customer service.

Files or state do not appear to persist

Check both the host-to-container path mapping and the host directory itself. For v2, configuration/state belongs at /core/config, while persistent internal files use /core/data. Recreating a container without the expected host mounts can leave its state non-persistent.

The legacy migration does not import settings

Confirm that the installation followed the v0.6.8 bridge and that the old configuration directory is mounted to /core/config in v2. Check that the host path points to the actual legacy database, not a new empty directory. The migration guide warns against skipping v0.6.8.

Rank #4
Sale
UGREEN USB to USB C Adapter Combo 4-Pack, 10Gbps USB C Converter Space Gray
  • Dual Converters, Infinite Potential:Includes 2× USB C male to USB A female adapters and 2× USB A male to USB C female adapters. Perfect for a wide range of uses—tablets with Bluetooth keyboards, expand USB ports on macbook, and more. Two different converters for all your daily needs
  • Next-Level 10Gbps & 3A Charging: No more slow 480Mbps, this usb to usb c adapter has a transfer speed of up to 10Gbps, allowing you to do more transferring in less time. This usb adapter fits both USB A and USB C charger, supporting up to 3A fast charging
  • Upgraded Exquisite Craftsmanship: With an aluminum alloy housing and metal connector, the usbc to usb adapter is extremely durable and sturdy. Rigorously tested to withstand more than 10,000 times of plugging and unplugging, ensuring long-lasting performance
  • Broad Compatible: The usb c to usb adapter widely supports all USB C/ USB A devices like laptops, tablets, cellphones, car chargers, and phone chargers. Such as compatible with MacBook Pro/Air 2023/2022, Thunderbolt 4/3 Devices,Apple MagSafe Watch 9/8/7/SE/Ultra, iPad Pro 2022/2021, Samsung Galaxy S23/S20/S10, and iPhone 17/16/15 Pro. Plug and play
  • Please Note: To reach 10Gbps speed, keep the cable under 3.3 ft. For USB A Male to USB C adapters, try flipping the USB C connector. USB C Male to USB A adapters support bidirectional 10Gbps transfer within 3.3 ft

The YouTube destination is absent or fails after the update

Restreamer’s documentation does not promise that every YouTube destination credential survives every version path. Review the destination and stream configuration in Restreamer, restore or re-enter the required credential if needed, and verify the setup before starting the broadcast.

A downgrade fails after updating to 2.4.0 or newer

FFmpeg 5.1.2 compatibility limits the documented downgrade route, and processes created in 2.4.0 or newer cannot be restored through it. Do not repeatedly switch image versions expecting a general rollback; refer to the migration guide’s narrow instructions and your preserved backup.

Special offer. See more information about Outbyte and uninstall instructions. Please review EULA and Privacy policy.
Best Value
Anker USB C Hub, 5-in-1 USBC to HDMI Splitter with 4K Display
  • 5-in-1 Connectivity: Equipped with a 4K HDMI port, a 5 Gbps USB-C data port, two 5 Gbps USB-A ports, and a USB C 100W PD-IN port. Note: The USB C 100W PD-IN port supports only charging and does not support data transfer devices such as headphones or speakers.
  • Powerful Pass-Through Charging: Supports up to 85W pass-through charging so you can power up your laptop while you use the hub. Note: Pass-through charging requires a charger (not included). Note: To achieve full power for iPad, we recommend using a 45W wall charger.
  • Transfer Files in Seconds: Move files to and from your laptop at speeds of up to 5 Gbps via the USB-C and USB-A data ports. Note: The USB C 5Gbps Data port does not support video output.
  • HD Display: Connect to the HDMI port to stream or mirror content to an external monitor in resolutions of up to 4K@30Hz. Note: The USB-C ports do not support video output.
  • What You Get: Anker 332 USB-C Hub (5-in-1), welcome guide, our worry-free 18-month warranty, and friendly customer service.
Independent reader supportYour contribution helps us test, update, and keep practical guides available for everyone.Support on Ko-Fi

Or let it run in the cloud

If your goal is a YouTube channel that keeps uploaded videos playing around the clock, StreamNeo is a separate cloud option rather than a Restreamer updater: upload a recording or build a playlist, add your YouTube stream key once, and go live. Nothing has to stay on at home; it streams your upload at its original quality up to 4K 60fps for one flat price per slot, automatically recovers if YouTube drops the stream, and the first day is free with no card. Monthly is $9.99 per month. StreamNeo plays uploaded videos and streams to YouTube only. Learn more at StreamNeo, or start your free day.

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.