# guoyoudu/docker-jitsi-meet architecture

> Architecture diagram of the GitHub repository guoyoudu/docker-jitsi-meet, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-08-15). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/guoyoudu/docker-jitsi-meet
- Repository: https://github.com/guoyoudu/docker-jitsi-meet

## Overview

##### Project type and purpose
- This is a container‐based, multi-service deployment of Jitsi Meet—a fully open‐source, encrypted video‐conferencing solution—packaged via Docker and Docker Compose.
- The repository provides one Docker image per Jitsi component (web, prosody, jicofo, jvb, jigasi, jibri, transcriber) along with an integrated logging/monitoring stack (Prometheus, Loki, Grafana).

##### File structure
- Top‐level orchestrator:
- docker-compose.yml – defines the services and inter‐container networks.
- Service directories: each subfolder (web, prosody, jicofo, jvb, jigasi, jibri, transcriber, log-analyser, prometheus) contains:
- Dockerfile – builds the container image
- rootfs/etc/services.d – run scripts & init hooks
- rootfs/defaults – default config files
- Monitoring:
- prometheus/ and log-analyser/ folders with configs for Prometheus, Loki, Grafana provisioning
- Base images: shared “base” and “base-java” Dockerfiles for repeatable build environments.
- CI/CD workflows in .github/workflows for build, test, release pipelines.

##### README for additional insights
- Confirms use of Docker Compose to spin up a full Jitsi stack (web frontend, XMPP signaling, conferencing focus, media router, SIP gateway, recording, transcription).
- Mentions multi‐arch support (amd64, arm64) and linkage to Kubernetes tooling (external).
- No built‐in TURN server yet—external TURN/STUN needs to be added for NAT traversal.

a. Main components
- Client browsers/mobile apps
- “web” container: HTTPS → Nginx + Prosody WebSockets proxy, static assets, config.js
- “prosody” container: XMPP signaling, authentication, MUC (multi‐user chat) rooms
- “jicofo” container: Conference focus component, XMPP control
- “jvb” container: VideoBridge—media router handling RTP/ICE
- “jigasi” container: SIP gateway (audio calls with PSTN/SIP)
- “jibri” container: Recorder & SIP gateway for recording/streaming
- “transcriber” container: Transcription sidecar
- Monitoring stack: Prometheus (scrapes exporters/sidecars), Loki (logs), Grafana (dashboards)
- External services: TURN/STUN server, OAuth / JWT auth providers (optional)

b. Relationships and interactions
- Clients ⇄ web (HTTPS/WSS)
- web ⇄ prosody (WS XMPP over internal network)
- prosody ⇄ jicofo/jigasi/jibri (XMPP pub/sub RPC control)
- jicofo ⇄ jvb (XMPP commands to allocate channels)
- Clients ⇄ jvb (media: RTP/UDP, ICE negotiation via STUN/TURN)
- jigasi/jibri communicate via XMPP and spawn local headless processes
- All containers expose Prometheus metrics endpoints; log outputs are shipped to Loki
- Prometheus scrapes, Grafana queries Prometheus & Loki

c. Architectural patterns and principles
- Microservice per functionality
- Sidecar pattern for healthchecks, autoscaler‐sidecar, config/init hooks
- Configuration‐as‐code: defaults in rootfs/defaults, overrides via environment variables
- Orchestration via Docker Compose networking
- Observability: metrics + logs + dashboards

d. Key technologies, frameworks, libraries
- Docker, Docker Compose
- Alpine Linux-based custom rootfs with s6‐overlay init system
- Nginx, Prosody XMPP, Jicofo (Java), JVB (Java), Jigasi (Java), Jibri (Java + Chrome), optional transcription engine
- Prometheus, Grafana, Loki, OpenTelemetry Collector

##### Final advice
- Every container as a separate component.
- Clearly separate control plane (XMPP, APIs) from data plane (media).
- Sidecar/healthcheck containers or processes if relevant to deployment logic.
- The goal is a comprehensive, at‐a‐glance view of how all pieces interconnect under Docker Compose.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Orchestrator
    subgraph "Orchestrator"
        DC["Docker Compose Orchestrator"]:::orchestrator
    end

    %% Jitsi Core
    subgraph "Jitsi Core"
        Clients["Clients (Browser/Mobile)"]:::external
        Web["web"]:::frontend
        Prosody["prosody"]:::signaling
        Jicofo["jicofo"]:::signaling
        JVB["jvb"]:::media
        Jigasi["jigasi"]:::media
        Jibri["jibri"]:::media
        Transcriber["transcriber"]:::media
    end

    %% Monitoring Stack
    subgraph "Monitoring Stack"
        Prometheus["Prometheus"]:::monitor
        Loki["Loki"]:::monitor
        Grafana["Grafana"]:::monitor
    end

    %% Utilities
    subgraph "Utilities"
        Base["base / base-java"]:::base
        CICD["CI/CD Workflows"]:::ci
    end

    %% External Dependencies
    TURN["TURN/STUN"]:::external
    Auth["OAuth/JWT Provider"]:::external

    %% Network
    DC -->|"spins up"| Web
    DC -->|"spins up"| Prosody
    DC -->|"spins up"| Jicofo
    DC -->|"spins up"| JVB
    DC -->|"spins up"| Jigasi
    DC -->|"spins up"| Jibri
    DC -->|"spins up"| Transcriber
    DC -->|"spins up"| Prometheus
    DC -->|"spins up"| Loki
    DC -->|"spins up"| Grafana

    Clients -->|"HTTPS/WSS"| Web
    Web -->|"WS XMPP"| Prosody
    Prosody -->|"XMPP RPC"| Jicofo
    Prosody -->|"XMPP RPC"| Jigasi
    Prosody -->|"XMPP RPC"| Jibri
    Jicofo -->|"XMPP channels"| JVB
    Clients ---|media RTP/UDP| JVB
    Clients -->|"STUN/TURN"| TURN
    Web -->|"OAuth/JWT"| Auth

    %% Monitoring flows
    Web -.->|"metrics"| Prometheus
    Prosody -.->|"metrics"| Prometheus
    Jicofo -.->|"metrics"| Prometheus
    JVB -.->|"metrics"| Prometheus
    Jigasi -.->|"metrics"| Prometheus
    Jibri -.->|"metrics"| Prometheus
    Transcriber -.->|"metrics"| Prometheus

    Web -.->|"logs"| Loki
    Prosody -.->|"logs"| Loki
    Jicofo -.->|"logs"| Loki
    JVB -.->|"logs"| Loki
    Jigasi -.->|"logs"| Loki
    Jibri -.->|"logs"| Loki
    Transcriber -.->|"logs"| Loki

    Grafana -->|"queries"| Prometheus
    Grafana -->|"queries"| Loki

    %% Click events
    click DC "https://github.com/guoyoudu/docker-jitsi-meet/blob/master/docker-compose.yml"
    click Web "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/web/Dockerfile"
    click Web "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/web/rootfs"
    click Prosody "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/prosody/Dockerfile"
    click Prosody "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/prosody/rootfs"
    click Jicofo "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/jicofo/Dockerfile"
    click Jicofo "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/jicofo/rootfs"
    click JVB "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/jvb/Dockerfile"
    click JVB "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/jvb/rootfs"
    click Jigasi "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/jigasi/Dockerfile"
    click Jigasi "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/jigasi/rootfs"
    click Jibri "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/jibri/Dockerfile"
    click Jibri "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/jibri/rootfs"
    click Transcriber "https://github.com/guoyoudu/docker-jitsi-meet/blob/master/transcriber.yml"
    click Prometheus "https://github.com/guoyoudu/docker-jitsi-meet/blob/master/prometheus/prometheus.yml"
    click Prometheus "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/prometheus/"
    click Loki "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/log-analyser/"
    click Base "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/base/Dockerfile"
    click Base "https://github.com/guoyoudu/docker-jitsi-meet/tree/master/base-java/Dockerfile"
    click CICD "https://github.com/guoyoudu/docker-jitsi-meet/blob/master/.github/workflows/ci.yml"
    click CICD "https://github.com/guoyoudu/docker-jitsi-meet/blob/master/.github/workflows/release-stable.yml"
    click CICD "https://github.com/guoyoudu/docker-jitsi-meet/blob/master/.github/workflows/unstable.yml"
    click CICD "https://github.com/guoyoudu/docker-jitsi-meet/blob/master/.github/workflows/stale.yml"

    %% Styles
    classDef frontend fill:#e0f7e9,stroke:#2e7d32
    classDef signaling fill:#e3f2fd,stroke:#1565c0
    classDef media fill:#fff3e0,stroke:#ef6c00
    classDef monitor fill:#f5f5f5,stroke:#616161
    classDef orchestrator fill:#ede7f6,stroke:#512da8
    classDef external fill:#ffebee,stroke:#b71c1c
    classDef base fill:#ffffff,stroke:#9e9e9e,stroke-dasharray: 5 5
    classDef ci fill:#fffde7,stroke:#f9a825
```
