Getting Started with Restreamer

Restreamer (by datarhei) is a free, open-source live streaming solution that lets you ingest a video source and push it to multiple platforms simultaneously — YouTube Live, Twitch, Facebook Live, and any custom RTMP destination — all from a self-hosted web interface. Available as a managed service in Eyevinn Open Source Cloud.

Prerequisites

Step 1: Create a Restreamer instance

Navigate to the Restreamer service in the OSC web console. Click Create restreamer and enter a name for your instance (letters, numbers, and underscores only).

Once the status indicator turns green and shows running, click the instance card to open the Restreamer web interface.

Step 2: Initial setup and login

On first launch Restreamer will prompt you to create an admin account. Choose a username and a strong password — these become your permanent login credentials.

After logging in you will see the Restreamer dashboard where you can configure your video sources and streaming destinations.

Step 3: Configure a video source

In the Restreamer UI, click + Add Source and choose how your video arrives:

  • RTMP — push a stream from OBS, ffmpeg, or any RTMP encoder to the instance's RTMP ingest URL (shown in the UI)
  • URL — pull from an existing HLS, RTMP, or file URL
  • Webcam / capture device — if running locally with hardware access

Step 4: Add streaming destinations

After configuring a source, click + Add Destination and select the platform or enter a custom RTMP URL. For each platform you will need the platform's Stream Key (available in each platform's broadcast settings).

Common destinations:

Platform RTMP URL
YouTube Live rtmp://a.rtmp.youtube.com/live2
Twitch rtmp://live.twitch.tv/live
Facebook Live rtmps://live-api-s.facebook.com:443/rtmp
Custom Any rtmp:// endpoint

Restreamer will push your source stream to all configured destinations simultaneously.

Usage example

Ingest with ffmpeg and push to your Restreamer instance:

INSTANCE_URL=https://mystream.datarhei-restreamer.auto.prod.osaas.io

ffmpeg -re -i input.mp4 \
  -c:v libx264 -preset veryfast -b:v 3000k \
  -c:a aac -b:a 128k \
  -f flv rtmp://${INSTANCE_URL}/live/stream

CLI usage

osc create datarhei-restreamer mystream -o name="mystream"

Resources