docker-mjpg-streamer's Introduction

docker-mjpg-streamer

This is a Dockerfile to set up mjpg-streamer. It supports the following architectures automatically:

amd64
arm/v6
arm/v7
arm64

Tested devices

Device	Working?
amd64	Untested
Raspberry Pi 2b	Untested
Raspberry Pi 3b+	✅
Raspberry Pi 4b	Untested
Raspberry Pi Zero W	Untested

Please let me know if you test any others, would love to increase the compatibility list!

Usage

$ docker run \
  --device=/dev/video0 \
  -p 8080:8080 \
  patsoffice/mjpg-streamer

Environment Variables

Variable	Description	Default Value
CAMERA_DEV	The camera device node	`/dev/video0`
MJPEG_STREAMER_INPUT	Flags to pass to mjpg_streamer	`-y -n -r 640x480`

Webcam integration

USB Webcam

Bind the camera to the docker using --device=/dev/video0:/dev/videoX
Optionally, change MJPEG_STREAMER_INPUT to your preferred settings (ex: input_uvc.so -y -n -r 1280x720 -f 10)

Raspberry Pi camera module

The camera module must be activated (sudo raspi-config -> interfacing -> Camera -> set it to YES)
Memory split must be at least 128mb, 256mb recommended. (sudo raspi-config -> Advanced Options -> Memory Split -> set it to 128 or 256)
You must allow access to device: /dev/vchiq
Change MJPEG_STREAMER_INPUT to use input_raspicam.so (ex: input_raspicam.so -fps 25)

Octoprint integration

Use the following settings in octoprint:

webcam:
  stream: http://name-of-your-docker-host:8080/?action=stream
  snapshot: http://name-of-mjpg-streamer-container:8080/?action=snapshot
  ffmpeg: /opt/ffmpeg/ffmpeg

The steam URL needs to be able to connect from your web browser but the snapshots can connect over the internal docker network. If you are using the official Octoprint container, the path to the ffmpeg binary is /opt/ffmpeg/ffmpeg.