mirror of
https://github.com/YunoHost-Apps/galene_ynh.git
synced 2024-09-03 18:36:31 +02:00
42 lines
2.2 KiB
Markdown
42 lines
2.2 KiB
Markdown
### Configure your groups
|
|
|
|
*Galène* meeting rooms are called "groups".
|
|
|
|
Any group is accessible at `https://domain.tld/group/GroupName`, by typing its name in the home page search field, or by selecting it in the public list (if the group is configured as publicly visible, see below).
|
|
|
|
#### Configuring groups and adding new ones
|
|
|
|
Groups are defined by *json* files located in *Galène* folder (`/opt/yunohost/galene/groups`). Each group is represented by a `GroupName.json` file.
|
|
To create a new group, you need to create a `GroupNameExample.json` file (you can also make subfolder, and the groups will be accessible with `https://domain.tld/group/subfolder/GroupName`). Various options are available (see https://github.com/YunoHost-Apps/galene_ynh/wiki/Configuration-file)
|
|
|
|
*NB: spaces are supported in group file names.*
|
|
|
|
### Configure your TURN server
|
|
|
|
#### Using Galène Turn server
|
|
Galène comes with build in TURN server that should work out-of-the-box.
|
|
- If your server is behind NAT, allow incoming traffic to TCP port `8443` (or whatever is configured with the `-http` option in `/etc/systemd/system/galene.service`) and port `1194` (or whatever is configured with the `-turn` option in `/etc/systemd/system/galene.service`)
|
|
|
|
#### Using you own TURN server
|
|
- Install [coturn_ynh](https://github.com/YunoHost-Apps/coturn_ynh).
|
|
- Add `/opt/yunohost/galene/data/ice-servers.json` with this lines and change `turn.example.org` and `secret`
|
|
|
|
```
|
|
[
|
|
{
|
|
"urls": [
|
|
"turn:turn.example.org:443",
|
|
"turn:turn.example.org:443?transport=tcp"
|
|
],
|
|
"username": "galene",
|
|
"credential": "secret"
|
|
}
|
|
]
|
|
```
|
|
- set `/etc/systemd/system/galene.service` turn option to `-turn auto`. (or `-turn ""` to disable the built in TURN server)
|
|
|
|
To check if the TURN server is up and running, type `/relay-test` in the chat box; if the TURN server is properly configured, you should see a message saying that the relay test has been successful.
|
|
|
|
### Server Statistics page
|
|
|
|
Some statistics are available under `/opt/yunohost/galene/stats.json`, with a human-readable version at `daomain.ltd/stats.html`. This is only available to the server administrator.
|