Skip to content

Latest commit

 

History

History
55 lines (37 loc) · 1.7 KB

Readme.md

File metadata and controls

55 lines (37 loc) · 1.7 KB
Raw

matrix migrate fork

This is a fork of acterglobal's matrix-migrate tool.

It implements features such as:

  • --dry-run flag to display what changes would be made
  • Selection/Excluding of rooms using --rooms or --rooms-excluded
  • --leave-rooms for cleanup after migration
    • Removes the old user from the rooms
    • Restores the is_direct flag, so DMs are not displayed as chat rooms
  • Increases sync timeout and allows to override it using --timeout

CLI to migrate one matrix account to a new one. Similar to the EMS migrator but:

  1. is a nice little CLI tool, based on matrix-rust-sdk
  2. allows for restarts (refreshes at the beginning)
  3. it runs the operations async and is thus a lot faster

Note: It currently only migrates the rooms listing and power_levels, no user settings or profile data.

Install and use

You need a recent [Rust] installation. Then you can either clone the repository and use cargo run or use cargo-install:

cargo install https://matrix.org/acterglobal/matrix-migrate

and then can run it by just doing

matrix-migrate

Usage note

It requires both the user and password for the user from and to either as command line parameters, or preferably as environment variables (FROM_USER=, FROM_PASSWORD). It uses matrix discovery but if that doesn't work for you you can provide custom homeservers, too.

It will start with a full-sync of the room state, so depending on the size of your matrix account(s), this may take a moment.

Changelog

Unreleased

  • Add support for matching up power_levels, needs latest matrix-rust-sdk-git