Installation

System Requirements

Runtime Environment

Item	Requirement
Operating System	Linux (recommended), macOS
CPU Architecture	x86_64, aarch64
Memory	Depends on concurrency scale, minimum 1GB recommended
Disk	Depends on recording requirements at runtime

Download Pre-compiled Binaries

Central index (tables and bin / beta paths): Downloads.

You can obtain CI release artifacts directly via the download domain (consistent with the Release workflow):

# Linux amd64
wget https://download.m7s.live/bin/monibuca_v6_linux_amd64.tar.gz
tar -xzf monibuca_v6_linux_amd64.tar.gz
chmod +x monibuca_linux_amd64
./monibuca_linux_amd64 -c config.yaml

# Linux arm64
wget https://download.m7s.live/bin/monibuca_v6_linux_arm64.tar.gz

Supported platforms:

linux/amd64
linux/arm64

Download Frontend ZIP Assets (Admin + Demo)

CI also publishes the following frontend packages, which can be placed directly in the server’s working directory and served by Monibuca’s built-in HTTP service:

https://download.m7s.live/bin/admin-en.zip
https://download.m7s.live/bin/demo-live-room-en.zip
https://download.m7s.live/bin/demo-meeting-room-en.zip
https://download.m7s.live/bin/demo-customer-service-en.zip

wget https://download.m7s.live/bin/admin-en.zip
wget https://download.m7s.live/bin/demo-live-room-en.zip
wget https://download.m7s.live/bin/demo-meeting-room-en.zip
wget https://download.m7s.live/bin/demo-customer-service-en.zip

After startup, you can access:

http://<host>:8180/admin
http://<host>:8180/demo/live-room
http://<host>:8180/demo/meeting-room
http://<host>:8180/demo/customer-service

Docker Deployment

Using Pre-built Images

# Full version (includes FFmpeg)
docker pull langhuihui/monibuca:v6

# Lightweight version (without FFmpeg, based on Alpine)
docker pull monibuca/v6:latest

Running the Container

docker run -d \
  --name monibuca \
  -p 8180:8180 \
  -p 8443:8443 \
  -p 1935:1935 \
  -p 8554:8554 \
  -p 50051:50051 \
  -p 6000:6000/udp \
  -p 9000-9100:9000-9100/udp \
  -v $(pwd)/config.yaml:/etc/monibuca/config.yaml \
  langhuihui/monibuca:v6

The container image includes the following static asset ZIPs (consistent with CI artifacts):

admin.zip (zh-CN), admin-en.zip (en)
demo-live-room.zip (zh-CN), demo-live-room-en.zip (en)
demo-meeting-room.zip (zh-CN), demo-meeting-room-en.zip (en)
demo-customer-service.zip (zh-CN), demo-customer-service-en.zip (en)

Port Reference

Port	Protocol	Description
`8180`	TCP	HTTP service (API, FLV, HLS, WebRTC, admin panel)
`8443`	TCP	HTTPS service
`1935`	TCP	RTMP
`8554`	TCP	RTSP
`6000`	UDP	SRT
`9000-9100`	UDP	WebRTC media ports
`50051`	TCP	gRPC

Docker Compose

services:
  monibuca:
    image: langhuihui/monibuca:v6
    ports:
      - "8180:8180"
      - "8443:8443"
      - "1935:1935"
      - "8554:8554"
      - "50051:50051"
      - "6000:6000/udp"
      - "9000-9100:9000-9100/udp"
    volumes:
      - ./config.yaml:/etc/monibuca/config.yaml
      - ./data:/monibuca/data
    environment:
      - M7S_GLOBAL_LOGLEVEL=info
    restart: unless-stopped

Verify Installation

After startup, visit the following addresses to verify the service is running properly:

# HTTP API
curl http://localhost:8180/api/summary

# Admin panel (open in browser)
# http://localhost:8180/admin

# Live Room Demo
# http://localhost:8180/demo/live-room

Plugin Development

Monibuca provides a standalone monibuca-sdk crate. You can develop custom plugins based on the SDK and run them in dynamic loading or WASM sandbox mode.

For detailed plugin development guides, see Plugin Development.

Installation complete? Continue reading Quick Start to learn the basic usage.