Service: Just Go Live - EyevinnOSC/community GitHub Wiki

Getting Started

Just Go Live is a one-click live streaming setup tool that uses your OSC account to automatically configure an RTMP ingest endpoint and HLS output stream. It generates the RTMP URL and stream key you need to broadcast from OBS, Streamlabs, or any RTMP-compatible encoder, and makes the live stream available as an HLS playback URL for viewers. Available in Eyevinn Open Source Cloud.

Prerequisites

Step 1: Store your access token as a secret

Navigate to the Just Go Live service, open the Service Secrets tab, and create a secret named osctoken with your personal access token as the value.

Step 2: Create a Just Go Live instance

Go to the My just-go-lives tab and click Create just-go-live. Fill in:

Field Description Example
Name Name for this streaming setup mystream
OscAccessToken Your OSC personal access token {{secrets.osctoken}}

Click Create and wait for the instance status to turn green.

Note: Allow 1-2 minutes after the instance status turns green before making your first API call. The instance hostname needs time to obtain a valid TLS certificate.

Step 3: Get your RTMP and HLS URLs

You need a Service Access Token for this step (not a Personal Access Token). A PAT returns a bare 401. Create one with create-service-token in the OSC AI chat, or via the API.

Call POST /api/go-live on your instance URL:

curl -X POST https://<tenant>-<instance>.eyevinn-just-go-live.auto.prod-se.osaas.io/api/go-live \
  -H "x-jwt: Bearer <serviceAccessToken>"

The response contains:

{
  "rtmpUrl": "rtmp://217.61.247.34:10519/live/<streamKey>",
  "viewerUrl": "...",
  "streamId": "<streamId>"
}

To get the HLS playback URL, call GET /api/stream/{streamId}:

curl https://<tenant>-<instance>.eyevinn-just-go-live.auto.prod-se.osaas.io/api/stream/<streamId> \
  -H "x-jwt: Bearer <serviceAccessToken>"

The response includes hlsUrl:

https://<tenant>-<encoderInstance>.eyevinn-live-encoding.auto.prod-se.osaas.io/origin/hls/index.m3u8

Verified URL formats (provision-verified by simfrisk, 2026-08-26, three tenants on prod-se)

Format
RTMP ingest rtmp://217.61.247.34:10519/live/<streamKey>
HLS playback https://<tenant>-<encoderInstance>.eyevinn-live-encoding.auto.prod-se.osaas.io/origin/hls/index.m3u8

The RTMP ingest endpoint uses a bare IP address and a non-standard port. The stream key is the only thing distinguishing one publisher from another — keep it private. The HLS playback URL is on the eyevinn-live-encoding encoder instance (not the just-go-live instance); the encoder instance name is generated automatically when you call POST /api/go-live.

Step 4: Configure OBS Studio

With your RTMP URL and stream key from Step 3:

  1. Open OBS Studio and go to Settings → Stream.
  2. Set Service to Custom.
  3. In the Server field, enter: rtmp://217.61.247.34:10519/live
  4. In the Stream Key field, enter the <streamKey> portion from the rtmpUrl (the part after /live/).
  5. Click OK, then click Start Streaming.

The HLS playback URL (hlsUrl) can be shared with viewers or embedded in a browser player using hls.js.

CLI Usage

npx -y @osaas/cli create eyevinn-just-go-live mystream \
  -o OscAccessToken="{{secrets.osctoken}}"

Auth note

POST /api/go-live and GET /api/stream/{streamId} require a Service Access Token (created with create-service-token). A Personal Access Token returns a bare nginx 401 with no error body. The OscAccessToken instance config field (which takes a PAT) is separate from the API auth token.

Resources

  • OSC Dashboard
  • Eyevinn Live Encoding — open source live encoder if you need more control over the transcoding pipeline
  • SRT WHEP Bridge — low-latency SRT-to-WebRTC alternative for contributors
⚠️ **GitHub.com Fallback** ⚠️