Migration

Migration notes for version breaks.
v2.4+ to v2.3.x (downgrade)
Restreamer version >= 2.4.0 switches to FFmpeg 5.1.2, which is incompatible with earlier versions.
However, if problems arise due to the update, there is a backup to downgrade to =< 2.3.x.
The required steps:
Guide
Linux example
Switch to the mounted Restreamer configuration folder
Docker parameter: -v /host/path:/core/config
Rename db.json to db_ff5.json 
Rename db_ff4.json to db.json
Start the Restreamer container with an older Docker image tag (e.g., datarhei/restreamer:2.3.0.)
1
docker kill restreamer
2
docker rm restreamer
3
cd /mnt/restreamer/config
4
mv db.json db_ff5.json
5
mv db_ff4.json db.json
6
docker run {used params...} datarhei/restreamer:2.3.0
Restoring the processes created with the new version >= 2.4.0, is impossible.
​
v0.6.x to v2.x
If you are currently using an older version of Restreamer and want to upgrade to the latest version, you have to follow these steps. In case you don't need or want to keep your current stream settings you can go the Quick Start page and install Restreamer v2.x from scratch.
This guide assumes that your current docker command line looks like
$ docker run -d --restart always \
     --name restreamer \
     -e "RS_USERNAME=admin" -e "RS_PASSWORD=datarhei" \
     -p 8080:8080 -v /mnt/restreamer/db:/restreamer/db \
     datarhei/restreamer:latest
Your actual command line might have more enviroment variables or different paths to the mounted directories.
1.Upgrade your Restreamer to v0.6.8 (https://github.com/datarhei/restreamer/releases/tag/v0.6.8). If you don't upgrade to v0.6.8, all your settings might get lost during the migration.
2.Start Restreamer v0.6.8 and start streaming from the video source.
3.Stop Restreamer v0.6.8 by stopping the Docker container, e.g. docker kill restreamer and then docker rm restreamer.
4.Pull the latest Restreamer image, e.g. docker pull datarhei/restreamer:latest.
5.Adjust the mounted volumes by replacing -v /mnt/restreamer/db:/restreamer/db with -v /mnt/restreamer/db:/core/config -v /opt/restreamer/data:/core/data in your docker command line.
6.Start Restreamer. Now the settings from v0.6.8 are imported to v2.x
7.Done.
Your docker command should now look like
$ docker run -d --restart always \
     --name restreamer \
     -e "RS_USERNAME=admin" -e "RS_PASSWORD=datarhei" \
     -p 8080:8080 \
     -v /mnt/restreamer/db:/core/config -v /opt/restreamer/data:/core/data \
     datarhei/restreamer:latest
After the old settings have been successfully imported, the old settings database (v1.json) stored in /mnt/restreamer/db will not be used anymore. A new settings database (db.json) and a config file (config.json) have been created in that directory.
Review your Docker command line
In case you are using any environment variables (command line options that start with -e RS_), they will be ignored after the first start of Restreamer v2.x (see step 6 above). You can remove them from your docker command line.
As in the example command line above, there are two environment variables RS_USERNAME and RS_PASSWORD. You can remove those because during the first start of Restreamer v2.x their values were transferred into the config.json.
Your docker command should now look like
$ docker run -d --restart always \
     --name restreamer \
     -p 8080:8080 \
     -v /mnt/restreamer/db:/core/config -v /opt/restreamer/data:/core/data \
     datarhei/restreamer:latest
Your actual command line might have different paths to the mounted directories. Please adjust the example above accordingly in case you want to copy/paste it.
Installing - Previous
Update
Next - Knowledge Base
Manual
Last modified 2mo ago