# OBS NDI

OBS NDI is a Docker container that runs Open Broadcaster Software (OBS) Studio with the NDI plugin built in, letting you stream your desktop from a headless server to NDI displays. It is open source and self-hosted, installable on Docker Hub and Unraid.

Canonical page: https://ourlocalhost.com/app/1598/obs-ndi

## Description

OBS NDI is a Docker container that runs Open Broadcaster Software (OBS) Studio with the NDI plugin built in, letting you stream your desktop from a headless server to NDI displays. It runs a full XFCE desktop over VNC on port 5901 with a web client on port 6901, exposes the NDI stream on port 4455, and includes obs-websocket support for remote control. It suits homelab users who want to broadcast from a server without a dedicated PC.

## Platform availability

Available on 1 of 10 platforms: Unraid.

## Health score

26/100 (Low), based on 5 of 5 factors.
- Maintained: 0 (last commit 1423 days ago)
- Popular: 29 (26 GitHub stars)
- Easy to install: 35 (1 install platform, install notes, Docker image)
- Light to run: 10 (6 GB minimum RAM)
- Security check: 75 (no serious findings)

## Links

- Docker Hub: https://hub.docker.com/repository/docker/patrickstigler/obs-ndi
- Unraid: https://ca.unraid.net/apps/obs-ndi-01osug416cqamw?q=obs-ndi

## Common questions

### How do I access the container's desktop interface?

Use a VNC client on port 5901 or the web client on port 6901. The VNC password is headless.

### What Docker option should I add to avoid the web VNC client crashing?

Run the container with --shm-size=256m so the webclient does not run out of shared memory and crash.

### How do I enable NVIDIA GPU support for the container?

Add --runtime=nvidia to the Docker command. Also set the environment variables NVIDIA_VISIBLE_DEVICES= and NVIDIA_DRIVER_CAPABILITIES=all.

### Can I control OBS from an external client or script?

The latest OBS in the container supports obs-websocket. The Docker run example maps port 4455 for this.

---
Source: Our Local Host (https://ourlocalhost.com/app/1598/obs-ndi), the self-hosted and open-source app directory.
