Related to: - https://github.com/spantaleev/matrix-docker-ansible-deploy/pull/1727 - https://github.com/spantaleev/matrix-docker-ansible-deploy/pull/1754 - https://github.com/spantaleev/matrix-docker-ansible-deploy/pull/1755 - https://github.com/spantaleev/matrix-docker-ansible-deploy/issues/467pull/1768/head
| @@ -1,5 +1,12 @@ | |||||
| # 2022-04-19 | # 2022-04-19 | ||||
| ## Borg backup support | |||||
| Thanks to [Aine](https://gitlab.com/etke.cc) of [etke.cc](https://etke.cc/), the playbook can now set up [Borg](https://www.borgbackup.org/) backups with [borgmatic](https://torsion.org/borgmatic/) of your Matrix server. | |||||
| See our [Setting up borg backup](docs/configuring-playbook-backup-borg.md) documentation to get started. | |||||
| ## (Compatibility Break) Upgrading to Synapse v1.57 on setups using workers may require manual action | ## (Compatibility Break) Upgrading to Synapse v1.57 on setups using workers may require manual action | ||||
| If you're running a worker setup for Synapse (`matrix_synapse_workers_enabled: true`), the [Synapse v1.57 upgrade notes](https://github.com/matrix-org/synapse/blob/v1.57.0rc1/docs/upgrade.md#changes-to-database-schema-for-application-services) say that you may need to take special care when upgrading: | If you're running a worker setup for Synapse (`matrix_synapse_workers_enabled: true`), the [Synapse v1.57 upgrade notes](https://github.com/matrix-org/synapse/blob/v1.57.0rc1/docs/upgrade.md#changes-to-database-schema-for-application-services) say that you may need to take special care when upgrading: | ||||
| @@ -8,6 +8,9 @@ You will need a remote server where borg will store the backups. There are hoste | |||||
| The backup will run based on `matrix_backup_borg_schedule` var (systemd timer calendar), default: 4am every day. | The backup will run based on `matrix_backup_borg_schedule` var (systemd timer calendar), default: 4am every day. | ||||
| By default, if you're using the integrated Postgres database server (as opposed to [an external Postgres server](configuring-playbook-external-postgres.md)), Borg backups will also include dumps of your Postgres database. An alternative solution for backing up the Postgres database is [postgres backup](configuring-playbook-postgres-backup.md). If you decide to go with another solution, you can disable Postgres-backup support for Borg using the `matrix_backup_borg_postgresql_enabled` variable. | |||||
| ## Prerequisites | ## Prerequisites | ||||
| 1. Create a new SSH key: | 1. Create a new SSH key: | ||||
| @@ -2,6 +2,9 @@ | |||||
| The playbook can install and configure [docker-postgres-backup-local](https://github.com/prodrigestivill/docker-postgres-backup-local) for you. | The playbook can install and configure [docker-postgres-backup-local](https://github.com/prodrigestivill/docker-postgres-backup-local) for you. | ||||
| For a more complete backup solution (one that includes not only Postgres, but also other configuration/data files), you may wish to look into [borg backup](configuring-playbook-backup-borg.md) instead. | |||||
| ## Adjusting the playbook configuration | ## Adjusting the playbook configuration | ||||
| Minimal working configuration (`inventory/host_vars/matrix.DOMAIN/vars.yml`) to enable Postgres backup: | Minimal working configuration (`inventory/host_vars/matrix.DOMAIN/vars.yml`) to enable Postgres backup: | ||||
| @@ -152,6 +152,13 @@ When you're done with all the configuration you'd like to do, continue with [Ins | |||||
| - [Setting up Mjolnir](configuring-playbook-bot-mjolnir.md) - a moderation tool/bot (optional) | - [Setting up Mjolnir](configuring-playbook-bot-mjolnir.md) - a moderation tool/bot (optional) | ||||
| ### Backups | |||||
| - [Setting up borg backup](configuring-playbook-backup-borg.md) - a full Matrix server backup solution, including the Postgres database (optional) | |||||
| - [Setting up postgres backup](configuring-playbook-postgres-backup.md) - a Postgres-database backup solution (note: does not include other files) (optional) | |||||
| ### Other specialized services | ### Other specialized services | ||||
| - [Setting up the Sygnal push gateway](configuring-playbook-sygnal.md) (optional) | - [Setting up the Sygnal push gateway](configuring-playbook-sygnal.md) (optional) | ||||