- Raspberry Pi 1 / Pi 2 / Pi 3 or Odroid U3
- ARM CPU that supports the
Raspberry Pi 1 / Pi 2 / Pi 3
Install the latest Raspian Stretch image on the SD card
Login to the Pi and install Docker CE according to the Debian install instructions
- Odroid U3 (discontinued)
Install the latest Ubuntu image on the SD card
Login to the Odroid and install Docker CE according to the Unbuntu install instructions
- Start the Restreamer
$ docker run -d --restart always \ --name restreamer \ -e "RS_USERNAME=admin" -e "RS_PASSWORD=datarhei" \ -p 8080:8080 -v /mnt/restreamer/db:/restreamer/db \ --tmpfs /tmp/hls \ datarhei/restreamer-armv7l:latest
- Browse to http://your-device-ip:8080
The default login is:
It is highly recommended to change the username and password.
It is recommended to change the username and password. In order to change them you have to set the respective environment variables in the docker command:
$ docker run ... -e "RS_USERNAME=YOUR_USERNAME" -e "RS_PASSWORD=YOUR_PASSWORD" ...
Description of the command
Detach the container. This means that the container will run in the background. You can run it interactively in the foreground with
-it instead of
-d. To stop the Restreamer in detached mode, type
docker stop restreamer. In interactive mode just hit
stop the Restreamer.
Gives the container the name
restreamer. This name can be used in other docker commands to control the container. In order to
stop the Restreamer, type
docker stop restreamer. While the Restreamer is running you can log in into the container with
docker exec -it restreamer /bin/bash.
In case the Restreamer crashes, Docker will automatically restart the Restreamer.
-e "RS_USERNAME=..." -e "RS_PASSWORD=..."
Set values for the environment variables
RS_PASSWORD. See a description of all known environment variables.
Bind the port 8080 of the device to the port 8080 of the Restreamer. With this you can connect with your browser to the Restreamer GUI.
If you want to us another port, change it to e.g.
This will mount the directory
/tmp/hls as a disk in the RAM of the container. This directory holds the chunks for the HLS chunks and has a lot I/O
operations on it. By mounting it to a
tmpfs you avoid wearing out the SD card in your device.
The Restreamer stores the current state in the directory
/restreamer/db inside the container. This command maps the directory
of your device into the container. With this the state can be preserved in case the Restreamer needs to be restarted. If you want to store
the state in a different directory on your device, change it to e.g.
This is the docker image of the lastest Restreamer on the Docker Hub. Docker will check if the image is locally available and download it if it is not available or a newer image is available.