Bash scripts for backup/restore of Matrix Synapse
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
DecaTec 9b4fe4316d Added timestamps 4 weeks ago Added timestamps 4 weeks ago
LICENSE Init 9 months ago Added timestamps 4 weeks ago Added timestamps 4 weeks ago Readme, changelog 9 months ago


This repository contains two bash scripts for backup/restore of Matrix Synapse.

General information

For a complete backup of any Matrix Synapse instance, you'll have to backup these items:

  • The install directory of Matrix Synapse (usually /etc/matrix-synapse/)
  • The lib directory of Matrix Synapse (usually /var/lib/matrix-synapse/)
  • The Matrx Synapse database (PostgreSQL or SQLite)

The scripts take care of these items to backup automatically.


  • After cloning or downloading the repository, you'll have to edit the scripts so that they represent your current Matrix Synapse installation (directories, DB, etc.). All values which need to be customized are marked with TODO in the script's comments.


In order to create a backup, simply call the script on your Matrix Synapse machine. If this script is called without parameter, the backup is saved in a directory with the current time stamp in your main backup directory: As an example, this would be /media/hdd/matrix_backup/20170910_132703. The backup script can also be called with a parameter specifiying the main backup directory, e.g. ./ /media/hdd/matrix_backup. In this case, the directory specified will be used as main backup directory.


For restore, just call This script expects at least one parameter specifying the name of the backup to be restored. In our example, this would be 20170910_132703 (the time stamp of the backup created before). The full command for a restore would be ./ 20170910_132703. You can also specify the main backup directory with a second parameter, e.g. ./ 20170910_132703 /media/hdd/matrix_backup.