Skip to main content

Turn off federation


  • Need to turn off federation, which is on by default.


  • Element On-Premise Installer


Add an empty federation_domain_whitelist. To do this, add the following in a .yml file in the Synapse config folder:


See for further details.

N.B. we recommend also firewalling your federation listener to limit inbound federation traffic as early as possible, rather than relying purely on this application-layer restriction. If not specified, the default is to whitelist everything.

Root Cause

Federation is on by default.