Diff

mod_reload_modules/README.markdown @ 1803:4d73a1a6ba68

Convert all wiki pages to Markdown
author Kim Alvefur <zash@zash.se>
date Fri, 28 Aug 2015 18:03:58 +0200
line wrap: on
line diff
--- /dev/null	Thu Jan 01 00:00:00 1970 +0000
+++ b/mod_reload_modules/README.markdown	Fri Aug 28 18:03:58 2015 +0200
@@ -0,0 +1,34 @@
+---
+labels:
+- 'Stage-Stable'
+summary: Automatically reload modules with the config
+...
+
+Introduction
+------------
+
+By default Prosody does not reload modules at runtime unless instructed
+to via one of its admin interfaces. However sometimes you want to easily
+reload a module to apply new settings when the config changes.
+
+mod\_reload\_modules will reload a set list of modules every time
+Prosody reloads its config (e.g. on SIGHUP).
+
+Configuration
+-------------
+
+Add "reload\_modules" to modules\_enabled. Then the list of modules to
+reload using the 'reload\_modules' option in your config like so:
+
+    reload_modules = { "groups", "tls" }
+
+This would reload mod\_groups and mod\_tls whenever the config is
+reloaded. Note that on many systems this will be at least daily, due to
+logrotate.
+
+Compatibility
+-------------
+
+  ----- -------
+  0.9   Works
+  ----- -------