NAME¶

SYNOPSIS¶

synctl {start|stop|restart} [configfile] [-w|--worker=WORKERCONFIG] [-a|--all-processes=WORKERCONFIGDIR]

DESCRIPTION¶

OPTIONS¶

action

The value of action should be one of start, stop or restart.

configfile

Optional path of the configuration file to use. Default value is homeserver.yaml. The configuration file must exist for the operation to succeed.

-w, --worker:

Perform start, stop or restart operations on a single worker. Incompatible with -a|--all-processes. Value passed must be a valid worker´s configuration file.

-a, --all-processes:

Perform start, stop or restart operations on all the workers in the given directory and the main synapse process. Incompatible with -w|--worker. Value passed must be a directory containing valid work configuration files. All files ending with .yaml extension shall be considered as configuration files and all other files in the directory are ignored.

CONFIGURATION FILE¶

$ python -B -m synapse.app.homeserver -c config.yaml --generate-config --server-name=<server name>
    

ENVIRONMENT¶

SYNAPSE_CACHE_FACTOR

Synapse´s architecture is quite RAM hungry currently - a lot of recent room data and metadata is deliberately cached in RAM in order to speed up common requests. This will be improved in future, but for now the easiest way to either reduce the RAM usage (at the risk of slowing things down) is to set the SYNAPSE_CACHE_FACTOR environment variable. Roughly speaking, a SYNAPSE_CACHE_FACTOR of 1.0 will max out at around 3-4GB of resident memory - this is what we currently run the matrix.org on. The default setting is currently 0.1, which is probably around a ~700MB footprint. You can dial it down further to 0.02 if desired, which targets roughly ~512MB. Conversely you can dial it up if you need performance for lots of users and have a box with a lot of RAM.

COPYRIGHT¶

SEE ALSO¶