▮ Getting started

Self-host Muxshed

Muxshed is a single Rust binary plus ffmpeg. Run it from source for development, or pull the Docker image to put it on your homelab. Both take a few minutes.

What you need

ffmpeg — powers ingest, fan-out, recording and the watch page
For source builds: Rust 1.84+ and Node.js 20+
For containers: Docker 24+ or Podman 4+

The fastest path

Pull and run the container, then open the UI and finish first-time setup in the browser:

docker run -d --name muxshed \
  -p 8080:8080 -p 1935:1935 -p 9000:9000/udp \
  -v muxshed-config:/config \
  ghcr.io/muxshed/muxshed:latest

Open http://localhost:8080, create your admin account, and you'll land in the studio. Point OBS at rtmp://localhost:1935/live with the stream key shown on the Sources page.

First run creates an admin account and an API key for Stream Deck / external tools. Save the API key — it's only shown once.

Then what?

Run from source for development
Docker & Podman for a permanent install
Configuration — ports, paths, env vars
Public watch page — broadcast to your own link

Run from source →