There is currently no documented way to upgrade a room version (typically 1 -> 4 as of writing) which is the new default room version for synapse. This ideally should be in the upgrade notes for Synapse.
The upgrade call is part of the Client-Server API: https://matrix.org/docs/spec/client_server/r0.5.0#id205
At this point we are not actively encouraging mods to upgrade their rooms unless they specifically need to (generally only applies to large public rooms).
Rationale is that we are still ironing out some bugs in the upgrade process and we expect further room versions.
an idiot proof version would be appreciated x)
For what it's worth for others reading, I found this purely by chance; you can do /upgraderoom 4 in riot-web to upgrade a room...
@nja0087 you the real MVP here
You'll also find support for rooms v6. v6 contains some small but important changes to improve the security of the room model. As with all room version upgrades we can't switch to v6 as the default version immediately since we need to build up a critical mass of servers that can support it. So upgrade and watch this space for when we switch over properly.
https://matrix.org/blog/2020/05/28/synapse-1-14-0-released
Is it highly recommended upgrading every room?
Does the upgrade create a new room? Will the history be lost?
If it's recommended for security reasons maybe it could be nice to have a warning in riot-web.
Does the upgrade create a new room? Will the history be lost?
I just tested upgrading a room from version 4 to 6 and it did indeed create a new room without the history from the previous room. You get a link at the start of the conversation in that room to see the history from the old room.
It would be nice, if the new room could be populated with the old history. So that the new room has the full history.
As one server does the creation of the new room, it should be able to prepopulate the history?
Most helpful comment
For what it's worth for others reading, I found this purely by chance; you can do
/upgraderoom 4in riot-web to upgrade a room...