external/mailinabox
1
0
Fork 0
mirror of https://github.com/mail-in-a-box/mailinabox.git synced 2025-04-05 00:27:25 +00:00
Code Issues Releases Wiki Activity

Add help text

Browse Source
This commit is contained in:
downtownallday 2021-10-02 10:10:06 -04:00
parent 66ac35871e
commit 31dc96757c
2 changed files with 47 additions and 0 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

25
setup/mods.available/README.md Normal file
View File

@ -0,0 +1,25 @@
This directory contains optional scripts that are run as part of setup (as the last step). They are disabled by default. To use them, create a `local` directory containing symbolic links to the mods you care to enable.
For example, to add coturn support for Nextcloud Talk do the following from the root directory of your installation:
```
mkdir -p local
ln -s ../setup/mods.available/coturn.sh local/coturn.sh
```
When `setup/start.sh` (or `ehdd/start-encrypted.sh`) are run, these scripts will be executed after setup has completed.
Before enabling any mod scripts from `setup/mods.available` (or elsewhere), be aware that they will likely modify your system, and that removal of the script from `local` will not restore the system to its pre-mod state. For example, enabling coturn, then removing the `local/coturn.sh` symlink, will not remove coturn from the system. It will still be active and enabled in systemd and firewall rules it added will still be in place.
**Before enabling any setup mod, it's very important that you look at the script and understand what it's doing and how to remove it.**
**USE OF SETUP MODS IS AT YOUR OWN RISK**
If you're creating your own setup mod, it should not store files in STORAGE_ROOT (/home/user-data) that are required at runtime due to encryption-at-rest issues. With encryption-at-rest enabled, STORAGE_ROOT (/home/user-data) is not available until the encrypted drive has been mounted (the sysadmin has manually keyed in the EHDD drive password) and any mod with a system service that starts without the drive available may fail or behave in unexpected ways.
If you wish to contribute your own mod, please create a PR to add it
to this directory. Ensure the script contains the author's name, when
it was last updated, requirements for running the script, and how to
remove it. Please note that this project is GPL and any contributions
will fall under that license.

22
setup/mods.available/coturn.sh
View File

@ -1,6 +1,28 @@
#!/bin/bash
# -*- indent-tabs-mode: t; tab-width: 4; -*-
# This mod is part of the Mail-In-A-Box LDAP and Cloud-In-A-Box
# projects
#
# It installs coturn - a stun/turn server needed for Nextcloud
# Talk. Once setup has been run with the mod enabled, configure
# Nextcloud Talk to use this host:
#
# STUN server:
# <hostname>:5349
#
# TURN server:
# turn: only
# <hostname>:5349
# secret: <retrieve 'static-auth-secret' from /etc/turnserver.conf>
# TCP only
#
# There is no automated removal of the mod - it must be manually
# removed by uninstalling coturn and removing the extra firewall
# rules. Simply removing the symlink in 'local' will not uninstall
# coturn.
#
[ -e /etc/mailinabox.conf ] && source /etc/mailinabox.conf
[ -e /etc/cloudinabox.conf ] && source /etc/cloudinabox.conf