# edumeet/edumeet-docker architecture

> Architecture diagram of the GitHub repository edumeet/edumeet-docker, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/edumeet/edumeet-docker
- Repository: https://github.com/edumeet/edumeet-docker

## Overview

This repository packages and configures a Dockerized eduMEET deployment rather than implementing the meeting services themselves. The main workflow is a visitor reaching the HTTPS proxy, which routes to the frontend and backend services; the room server uses the media node for call media. Authentication can be enabled with the management service and Keycloak. The README documents these service roles and some network paths, but the Compose, proxy, and service configuration contents were not excerpted, so internal routing details are limited to documented relationships.

Main entry points: [`docker-compose.yml`](https://github.com/edumeet/edumeet-docker/blob/main/docker-compose.yml) (Service deployment), [`configs/proxy/nginx.conf.template`](https://github.com/edumeet/edumeet-docker/blob/main/configs/proxy/nginx.conf.template) (Nginx proxy), [`Dockerfiles/Dockerfile-room-server`](https://github.com/edumeet/edumeet-docker/blob/main/Dockerfiles/Dockerfile-room-server) (Room server), [`Dockerfiles/Dockerfile-management-server`](https://github.com/edumeet/edumeet-docker/blob/main/Dockerfiles/Dockerfile-management-server) (Management server)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_edge["Public access"]
  node_proxy["Nginx proxy"]
  node_turn["TURN relay<br/>[docker-compose.yml]"]
end

subgraph group_meeting["Meeting services"]
  node_client["eduMEET client"]
  node_room["Room server"]
  node_media["Media node"]
end

subgraph group_auth["Authentication"]
  node_management["Management server"]
  node_keycloak["Keycloak<br/>[dev.json]"]
end

subgraph group_deployment["Deployment configuration"]
  node_compose["Service deployment<br/>[docker-compose.yml]"]
  node_service_config["Service configuration"]
  node_app_config["Client configuration<br/>[config.example.js]"]
  node_tls_certs["TLS certificates"]
end

node_visitor(("Visitor"))

node_visitor -->|"opens site"| node_proxy
node_proxy -->|"routes frontend"| node_client
node_proxy -->|"links services"| node_room
node_proxy -->|"routes management"| node_management
node_room -->|"uses media API"| node_media
node_proxy -->|"proxies TURN"| node_turn
node_management -.->|"uses OIDC"| node_keycloak
node_compose -.->|"starts services"| node_proxy
node_compose -.->|"starts services"| node_client
node_compose -.->|"starts services"| node_room
node_compose -.->|"starts services"| node_media
node_compose -.->|"starts services"| node_management
node_compose -.->|"starts services"| node_keycloak
node_compose -.->|"starts services"| node_turn
node_service_config -.->|"configures"| node_room
node_app_config -->|"configures"| node_client
node_tls_certs -->|"provides TLS"| node_proxy

click node_proxy "https://github.com/edumeet/edumeet-docker/blob/main/configs/proxy/nginx.conf.template"
click node_client "https://github.com/edumeet/edumeet-docker/blob/main/Dockerfiles/Dockerfile-client"
click node_room "https://github.com/edumeet/edumeet-docker/blob/main/Dockerfiles/Dockerfile-room-server"
click node_media "https://github.com/edumeet/edumeet-docker/blob/main/Dockerfiles/Dockerfile-media-node"
click node_management "https://github.com/edumeet/edumeet-docker/blob/main/Dockerfiles/Dockerfile-management-server"
click node_keycloak "https://github.com/edumeet/edumeet-docker/blob/main/configs/kc/dev.json"
click node_turn "https://github.com/edumeet/edumeet-docker/blob/main/docker-compose.yml"
click node_compose "https://github.com/edumeet/edumeet-docker/blob/main/docker-compose.yml"
click node_service_config "https://github.com/edumeet/edumeet-docker/blob/main/configs/server/config.json.template"
click node_app_config "https://github.com/edumeet/edumeet-docker/blob/main/configs/app/config.example.js"
click node_tls_certs "https://github.com/edumeet/edumeet-docker/tree/main/certs"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_proxy,node_turn toneBlue
class node_client,node_room,node_media toneAmber
class node_management,node_keycloak toneMint
class node_compose,node_service_config,node_app_config,node_tls_certs toneRose
class node_visitor toneIndigo
```

## Components

### Public access

- [Nginx proxy](https://github.com/edumeet/edumeet-docker/blob/main/configs/proxy/nginx.conf.template): `configs/proxy/nginx.conf.template`
- [TURN relay](https://github.com/edumeet/edumeet-docker/blob/main/docker-compose.yml): `docker-compose.yml`

### Meeting services

- [eduMEET client](https://github.com/edumeet/edumeet-docker/blob/main/Dockerfiles/Dockerfile-client): `Dockerfiles/Dockerfile-client`
- [Room server](https://github.com/edumeet/edumeet-docker/blob/main/Dockerfiles/Dockerfile-room-server): `Dockerfiles/Dockerfile-room-server`
- [Media node](https://github.com/edumeet/edumeet-docker/blob/main/Dockerfiles/Dockerfile-media-node): `Dockerfiles/Dockerfile-media-node`

### Authentication

- [Management server](https://github.com/edumeet/edumeet-docker/blob/main/Dockerfiles/Dockerfile-management-server): `Dockerfiles/Dockerfile-management-server`
- [Keycloak](https://github.com/edumeet/edumeet-docker/blob/main/configs/kc/dev.json): `configs/kc/dev.json`

### Deployment configuration

- [Service deployment](https://github.com/edumeet/edumeet-docker/blob/main/docker-compose.yml): `docker-compose.yml`
- [Service configuration](https://github.com/edumeet/edumeet-docker/blob/main/configs/server/config.json.template): `configs/server/config.json.template`
- [Client configuration](https://github.com/edumeet/edumeet-docker/blob/main/configs/app/config.example.js): `configs/app/config.example.js`
- [TLS certificates](https://github.com/edumeet/edumeet-docker/tree/main/certs): `certs`

### Other components

- **Visitor**

## Connections

- Visitor → Nginx proxy: opens site (evidence: `README.md`)
- Nginx proxy → eduMEET client: routes frontend (evidence: `README.md`)
- Nginx proxy → Room server: links services (evidence: `README.md`)
- Nginx proxy → Management server: routes management (evidence: `README.md`)
- Room server → Media node: uses media API (evidence: `README.md`)
- Nginx proxy → TURN relay: proxies TURN (evidence: `README.md`)
- Management server → Keycloak: uses OIDC (evidence: `README.md`)
- Service deployment → Nginx proxy: starts services
- Service deployment → eduMEET client: starts services
- Service deployment → Room server: starts services
- Service deployment → Media node: starts services
- Service deployment → Management server: starts services
- Service deployment → Keycloak: starts services
- Service deployment → TURN relay: starts services
- Service configuration → Room server: configures
- Client configuration → eduMEET client: configures (evidence: `configs/app/config.example.js`)
- TLS certificates → Nginx proxy: provides TLS (evidence: `README.md`)
