Galène is a videoconferencing server that is easy to deploy (just copy a few files and run the binary) and that requires moderate server resources. It was originally designed for lectures and conferences (where a single speaker streams audio and video to hundreds or thousands of users), but later evolved to be useful for student practicals (where users are divided into many small groups), and meetings (where a few dozen users interact with each other).
Galène's server side is implemented in Go, and uses the Pion implementation of WebRTC. The server has been tested on Linux/amd64 and Linux/arm64, and should in principle be portable to other systems (including Mac OS X and Windows). The client is implemented in Javascript, and works on recent versions of all major web browsers, both on desktop and mobile.
You can find out more on the Galène website.
Source code for this image is available on GitHub.
The image itself resides on Docker Hub.
This image is based on the galene44 image. But this image is self contained (you do need to clone the git repo) and it is small, the size is only 15.6MB.
Configuration is possible through environment variables.
docker run -it -p 8443:8443 -e GALENE_TURN= deburau/galene:latest
Or using docker-compose
version: '3'
services:
galene:
image: deburau/galene:latest
container_name: galene
restart: always
ports:
- 8443:8443
environment:
- GALENE_TURN=
:tada: You're now running Galène locally.
Please note that you may need a slightly more extended setup when you want to have conferences between multiple users.
If you want to use the built in turn server, you have to run the image in host mode:
docker run -it --network host -e GALENE_TURN=$(curl -4 ifconfig.co):1194 deburau/galene:latest
You can replace $(curl -4 ifconfig.co) with your server's ip address.
Docker-compose:
version: '3'
services:
galene:
image: deburau/galene:latest
container_name: galene
restart: always
network_mode: host
environment:
- GALENE_TURN=1.2.3.4:1194
To configure groups, passwords, ice servers etc. you can use volume mounts.
mkdir data groups
docker run -it \
-p 8443:8443 \
-e GALENE_TURN= \
-e GALENE_DATA=/data \
-e GALENE_GROUPS=/groups \
-v $PWD/data:/data \
-v $PWD/groups:/groups deburau/galene:latest
Docker-compose:
version: '3'
services:
galene:
image: deburau/galene:latest
container_name: galene
restart: always
volumes:
- ./data:/data
- ./groups:/groups
ports:
- 8443:8443
environment:
- GALENE_DATA=/data
- GALENE_GROUPS=/groups
- GALENE_TURN=
echo "admin:topsecret" > data/passwd
cat > groups/mygroup.json <<EOF
{
"codecs": ["vp8", "vp9", "opus"],
"autolock": false,
"op": [{"username": "myname", "password": "mypassword"}],
"presenter": [{"password": "grouppassword"}]
}
EOF
If you are running your own turn server, eg. coTURN, configure it like
cat > data/ice-servers.json <<EOF
[
{
"Urls": [
"turn:turn.example.com:5349?transport=tcp",
"turn:turn.example.com:5349?transport=udp"
],
"credential": "my-static-auth-secret",
"credentialType": "hmac-sha1"
}
]
EOF
To let the container wait the turn server to start, you can use docker-compose-wait. docker-compose-wait is configured through environment variables, you can read about them on the docker-compose-wait page.
| Environment Variable | Value | Description |
|---|---|---|
| GALENE_CPUPROFILE | file | Store CPU profile in file |
| GALENE_DATA | directory | Data directory |
| GALENE_GROUPS | directory | Group description directory |
| GALENE_HTTP | address | Web server address (default ":8443") |
| GALENE_INSECURE | 1 | Act as an HTTP server rather than HTTPS |
| GALENE_MDNS | 1 | Gather mDNS addresses |
| GALENE_MEMPROFILE | file | Store memory profile in file |
| GALENE_MUTEXPROFILE | file | Store mutex profile in file |
| GALENE_RECORDINGS | directory | Recordings directory |
| GALENE_REDIRECT | host | Redirect to canonical host |
| GALENE_RELAY_ONLY | 1 | Require use of TURN relays for all media traffic |
| GALENE_STATIC | directory | Web server root directory |
| GALENE_TURN | address | Built-in TURN server address ("" to disable) (default "auto") |
| WAIT_LOGGER_LEVEL | loglevel | The output logger level. Valid values are: debug, info, error, off. the default is debug. |
| WAIT_HOSTS | Comma separated list of pairs host:port for which you want to wait. | |
| WAIT_HOSTS_TIMEOUT | number | Max number of seconds to wait for all the hosts to be available before failure. The default is 30 seconds. |
| WAIT_HOST_CONNECT_TIMEOUT | number | The timeout of a single TCP connection to a remote host before attempting a new connection. The default is 5 seconds. |
| WAIT_BEFORE_HOSTS | number | Number of seconds to wait (sleep) before start checking for the hosts availability |
| WAIT_AFTER_HOSTS | number | Number of seconds to wait (sleep) once all the hosts are available |
| WAIT_SLEEP_INTERVAL | number | Number of seconds to sleep between retries. The default is 1 second. |
I am using it with my own turn server and traefik as reverse proxy.
version: '3'
services:
galene:
image: deburau/galene:latest
container_name: galene
restart: always
volumes:
- ./data:/data
- ./groups:/groups
- ./recordings:/recordings
- ./profiles:/profiles
networks:
traefik:
environment:
- WAIT_HOSTS=turn.example.com:5349
- WAIT_LOGGER_LEVEL=info
- WAIT_HOSTS_TIMEOUT=60
- WAIT_AFTER_HOSTS=1
- WAIT_SLEEP_INTERVAL=5
- GALENE_CPUPROFILE=/profiles/cpu.profile
- GALENE_DATA=/data
- GALENE_GROUPS=/groups
- GALENE_HTTP=:80
- GALENE_INSECURE=1
- GALENE_MDNS
- GALENE_MEMPROFILE/profiles/mem.profile
- GALENE_MUTEXPROFILE/profiles/mutex.profile
- GALENE_RECORDINGS=/recordings
- GALENE_REDIRECT
- GALENE_RELAY_ONLY
- GALENE_STATIC
- GALENE_TURN=
labels:
- "traefik.enable=true"
- "traefik.docker.network=traefik"
- "traefik.http.routers.galene.rule=Host(`galene.example.com`)"
- "traefik.http.routers.galene.entrypoints=websecure"
- "traefik.http.routers.galene.tls=true"
- "traefik.http.routers.galene.tls.domains[0].main=galene.example.com"
- "traefik.http.routers.galene.service=galene"
- "traefik.http.services.galene.loadbalancer.server.port=80"
- "traefik.http.services.galene.loadbalancer.server.scheme=http"
- "traefik.http.services.galene.loadbalancer.passhostheader=true"
networks:
traefik:
external: true
More examples and complete docs can be found in the garage44 wiki an the official site.
Content type
Image
Digest
sha256:d5aa75b3b…
Size
8.5 MB
Last updated
over 3 years ago
docker pull deburau/galene