Service: Owncast - EyevinnOSC/community GitHub Wiki

Owncast

Owncast (serviceId owncast-owncast, license MIT) is a self-hosted, open-source live video streaming and chat server. You stream to it from OBS, Restream or any RTMP-compatible encoder, and viewers watch through a built-in web player. In Eyevinn Open Source Cloud (OSC) it is a long-running service instance.

What it can do

  • Receive a live stream over RTMP from OBS or another RTMP-compatible encoder.
  • Serve a branded landing page with a built-in web player and chat.
  • Give you control over content, interface and audience without depending on a third-party platform.

Creating an instance

Owncast has no dependencies and its only option is the instance name. Call create-service-instance with serviceId: "owncast-owncast":

{ "name": "mylivestream" }

Then wait-for-service-ready (or get-instance-status) and describe-service-instance to get the instance URL.

Equivalent OSC CLI usage: osc create owncast-owncast mylivestream

Options

Option Required Type Meaning
name Yes string Unique name of the instance. Letters, digits and underscore (^\w+$); OSC limits names to 20 characters.

Using the instance

Admin panel

The admin panel is at /admin on the instance URL. Owncast's default credentials are username admin and password abc123. Change the admin password immediately in the admin panel (Server Setup, Basic Info).

Stream key

In the admin panel go to Server Setup, Basic Info and set a Stream Key. This is the key you enter in your streaming software.

Go live with OBS

In OBS Studio open Settings, Stream and configure:

Field Value
Service Custom
Server rtmp://<instance>.owncast-owncast.auto.prod-se.osaas.io/live
Stream Key The key you set in the admin panel

Start streaming; the stream appears on the Owncast landing page within a few seconds.

Resources

⚠️ **GitHub.com Fallback** ⚠️