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

Pre-built Binary Installation

Download the archive for your platform (Linux, macOS, Windows) from Downloads. For the admin panel and demos, also download the frontend ZIP bundles and extract them into your working directory.

After downloading and extracting, start Monibuca from your working directory:

# Linux amd64 example (binary name inside the archive may vary)
tar -xzf monibuca_v6_linux_amd64.tar.gz
chmod +x monibuca_linux_amd64
./monibuca_linux_amd64 -c config.yaml

On macOS the binary is monibuca_darwin_*; on Windows run monibuca.exe.

After extracting the frontend ZIPs, 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

docker-compose.yml

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.