Editing Telodendria (section)

== Configuring Telodendria ==
Telodendria essentially uses the filesystem as a database, and as such, you need to point it to an existing directory with the <code>-d [dir]</code> flag, like <code>telodendria -d data</code>.
From that directory, several things are stored, including the actual data Telodendria has to save in order to act as a Matrix homeserver, log files, and the configuration, as <code>[dir]/config.json</code>.

=== Modifying the configuration ===
{{Note|More information is available at Telodendria's wiki page on [https://git.telodendria.io/Telodendria/Telodendria/src/branch/master/docs/user/config.md configuration]}}
The configuration is stored in a JSON file called <code>[dir]/config.json</code>, which contains the following properties:
* <code>listen</code>: A required object list (Telodendria supports multiple listeners) storing ''where'' Telodendria should listen for requests:
** <code>port</code>: A required integer (between 1 and 65535) representing what port Telodendria listens to.
** <code>maxConnections</code>: An optional integer, defining the maximal amount of connections the listener should accept, which is 32 by default. You should play around, and see what values work the best for your loads.
** <code>threads</code>: An optional integer, defining the amount of threads the listener sets up, which is 4 by default. You should play around, and see what values work the best for your loads.
** <code>tls</code>: An optional object, containing both <code>cert</code> and <code>key</code>, which are both required paths to your certificate and key, in the format excepted by your TLS library.
* <code>log</code>: A required object storing how Telodendria should log:
** <code>output</code>: An enum, storing where Telodendria should log:
*** <code>"stdout"</code>: Write to the standard output.
*** <code>"syslog"</code>: Write to the system logger.
*** <code>"file"</code>: Write to the <code>[dir]/telodendria.log</code> file.
** <code>level</code>: An enum, storing the minimum level of severity for Telodendria to log an event:
*** <code>"message"</code>
*** <code>"debug"</code>
*** <code>"notice"</code>
*** <code>"warning"</code>
*** <code>"error"</code>
** <code>timestampFormat</code>: Represents the format Telodendria uses to write time information (see <code>strftime</code> for more).
** <code>color</code>: A boolean, determining whenever color should be enabled, whenever possible (if on an ANSI terminal)
* <code>runAs</code>: An object, that determines what user (<code>uid</code> as username) and role (<code>gid</code> as rolename) to run as if running as UID 0 (<code>root</code> in most systems)

* <code>serverName</code>: A required string, representing the server's name to the federation (see [[Delegation]])
* <code>baseUrl</code>: The URL used to prefix Matrix requests, when delegated
* <code>pid</code>: An optional PID file Telodendria creates and writes it's PID to when running.
* <code>federation</code>: A required boolean, used to determing whenever the server handles federation.
* <code>registration</code>: A required boolean, used to determing whenever the server supports open registration. Please note registration tokens do bypass this.
* <code>maxCache</code>: An optional integer, denoting how much cache to setup for the database in bytes, set to 0 by default.
* <code>identityServer</code>: An optional [[Identity server|identity server]] to advertise.