From ecc34afa8cacd6f116a327f1e54986b0298f96a5 Mon Sep 17 00:00:00 2001 From: ericgaspar Date: Fri, 15 Jan 2021 14:36:51 +0100 Subject: [PATCH] Add send email --- README.md | 29 ++++++++++++++++++++++++++++- scripts/install | 18 ++++++++++++++++++ scripts/restore | 15 +++++++++++++++ 3 files changed, 61 insertions(+), 1 deletion(-) diff --git a/README.md b/README.md index f1154eb..9b39d0e 100644 --- a/README.md +++ b/README.md @@ -23,7 +23,34 @@ Galène is a videoconferencing server that is easy to deploy (just copy a few fi ## Configuration -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. +### Turnserver + +For Voip and video conferencing a turnserver is also installed (and configured). The turnserver listens on two UDP and TCP ports. You can get them with these commands: + +``` +sudo yunohost app setting galene turnserver_tls_port +sudo yunohost app setting galene turnserver_alt_tls_port +``` + +The turnserver will also choose a port dynamically when a new call starts. The range is between 49153 - 49193. + +For some security reason the ports range (49153 - 49193) isn't automatically open by default. If you want to use the synapse server for voip or conferencing you will need to open this port range manually. To do this just run this command: + +``` +sudo yunohost firewall allow Both 49153:49193 +``` + +You might also need to open these ports (if it is not automatically done) on your ISP box. + +To prevent the situation when the server is behind a NAT, the public IP is written in the turnserver config. By this the turnserver can send its real public IP to the client. For more information see [the coturn example config file](https://github.com/coturn/coturn/blob/master/examples/etc/turnserver.conf#L102-L120).So if your IP changes, you could run the script `/opt/yunohost/__GALENE_INSTANCE_NAME__/Coturn_config_rotate.sh` to update your config. + +If you have a dynamic IP address, you also might need to update this config automatically. To do that just edit a file named `/etc/cron.d/coturn_config_rotate` and add the following content (just adapt the __SYNAPSE_INSTANCE_NAME__ which could be `galene` or maybe `galene__2`). + +``` +*/15 * * * * root bash /opt/yunohost/__GALENE_INSTANCE_NAME__/Coturn_config_rotate.sh; +``` + +To check if the TURN server is up and running in Galène, connect as operator and 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. ## Documentation diff --git a/scripts/install b/scripts/install index e0dd280..51df491 100755 --- a/scripts/install +++ b/scripts/install @@ -301,6 +301,24 @@ ynh_script_progression --message="Reloading NGINX web server..." --weight=2 ynh_systemd_action --service_name=nginx --action=reload +#================================================= +# SEND A README FOR THE ADMIN +#================================================= + +# WARNING : theses command are used in INSTALL, RESTORE +# For any update do it in all files + +echo " +You also need to open the TCP port $synapse_tls_port on your ISP box if it's not automatically done. + +Your Galène server also implements a turnserver (for VoIP), to have this fully functional please read the 'Turnserver' section in the README available here: https://github.com/YunoHost-Apps/galene_ynh . + +If you're facing an issue or want to improve this app, please open a new issue in this project: https://github.com/YunoHost-Apps/galene_ynh + +You also need a valid TLS certificate for the domain used by Galène. To do that you can refer to the documentation here: https://yunohost.org/#/certificate_en" > mail_to_send + +ynh_send_readme_to_admin --app_message="mail_to_send" --type="install" + #================================================= # END OF SCRIPT #================================================= diff --git a/scripts/restore b/scripts/restore index 643b8ed..2b08f92 100755 --- a/scripts/restore +++ b/scripts/restore @@ -200,6 +200,21 @@ setfacl -R -m user:turnserver:rwX /var/log/$app ynh_restore_file --origin_path="/etc/logrotate.d/$app" +#================================================= +# SEND A README FOR THE ADMIN +#================================================= + +# WARNING : theses command are used in INSTALL, RESTORE +# For any update do it in all files + +echo " + +Your Galène server also implements a turnserver (for VoIP), to have this fully functional please read the 'Turnserver' section in the README available here: https://github.com/YunoHost-Apps/galene_ynh . + +If you're facing an issue or want to improve this app, please open a new issue in this project: https://github.com/YunoHost-Apps/galene_ynh" > mail_to_send + +ynh_send_readme_to_admin --app_message="mail_to_send" --type="restore" + #================================================= # GENERIC FINALIZATION #=================================================