Split homeserver creation and setup #19015
Draft
+53
−22
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
As we already have the reactor running in the case of Synapse Pro for Small Hosts and `setup()` should handle everything
…round_tasks`" This reverts commit 211765f. (do this in another PR)
MadLittleMods
commented
Oct 3, 2025
Comment on lines
+447
to
+448
| # TODO: This should be moved to `SynapseHomeServer.start_background_tasks` (this | ||
| # way it matches the behavior of only running on `main`) |
There was a problem hiding this comment.
This is a future TODO
MadLittleMods
commented
Oct 3, 2025
|
|
||
| async def start() -> None: | ||
| async def _start_when_reactor_running() -> None: | ||
| # TODO: Feels like this should be moved somewhere else. |
There was a problem hiding this comment.
This is a future TODO
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Split homeserver creation and setup
Background
As part of Element's plan to support a light form of vhosting (virtual host) (multiple instances of Synapse in the same Python process), we're currently diving into the details and implications of running multiple instances of Synapse in the same Python process.
"Clean tenant provisioning" tracked internally by https://github.com/element-hq/synapse-small-hosts/issues/221
Partial startup problem
In the context of Synapse Pro for Small Hosts, since the Twisted reactor is already running (from the
multi_synapseshard process itself), when provisioning a homeserver tenant, thereactor.callWhenRunning(...)callbacks will be invoked immediately. This includes the Synapse'sstartcallback which sets up everything (including listeners, background tasks, etc). If we encounter an error at this point, we are partially setup but the exception will bubble back to us without us having a handle to the homeserver yet so we can't callhs.shutdown()and clean everything up.What does this PR do?
Structures Synapse so we split creating the homeserver instance from setting everything up. This way we have access to
hsif anything goes wrong during setup and can subsequentlyhs.shutdown()to clean everything up.Dev notes
Refactor with
start_background_tasks: #18886Pull Request Checklist
EventStoretoEventWorkerStore.".code blocks.