summary refs log tree commit diff
path: root/docs/usage
diff options
context:
space:
mode:
authorAmanda H. L. de Andrade Katz <amandahla@gmail.com>2023-12-05 08:42:56 -0300
committerGitHub <noreply@github.com>2023-12-05 11:42:56 +0000
commite87499b3f46a31c25df2da8686d3b913f8094660 (patch)
treeaa97bf78d185e2fa2db1a12ac623133238cce93c /docs/usage
parentSet response values to zero if None for /_synapse/admin/v1/federation/destina... (diff)
downloadsynapse-e87499b3f46a31c25df2da8686d3b913f8094660.tar.xz
Add how to validate configuration file with synapse.config script (#16714)
Diffstat (limited to 'docs/usage')
-rw-r--r--docs/usage/configuration/config_documentation.md17
1 files changed, 17 insertions, 0 deletions
diff --git a/docs/usage/configuration/config_documentation.md b/docs/usage/configuration/config_documentation.md
index e6fcffb570..425ec75542 100644
--- a/docs/usage/configuration/config_documentation.md
+++ b/docs/usage/configuration/config_documentation.md
@@ -33,6 +33,23 @@ In addition, configuration options referring to size use the following suffixes:
 For example, setting `max_avatar_size: 10M` means that Synapse will not accept files larger than 10,485,760 bytes
 for a user avatar.
 
+## Config Validation
+
+The configuration file can be validated with the following command:
+```bash
+python -m synapse.config read <config key to print> -c <path to config>
+```
+
+To validate the entire file, omit `read <config key to print>`:
+```bash
+python -m synapse.config -c <path to config>
+```
+
+To see how to set other options, check the help reference:
+```bash
+python -m synapse.config --help
+```
+
 ### YAML
 The configuration file is a [YAML](https://yaml.org/) file, which means that certain syntax rules
 apply if you want your config file to be read properly. A few helpful things to know: