# SOME DESCRIPTIVE TITLE. # Copyright (C) 2018-2024, Slavi Pantaleev, Aine Etke, MDAD community # members # This file is distributed under the same license as the # matrix-docker-ansible-deploy package. # FIRST AUTHOR , 2024. # #, fuzzy msgid "" msgstr "" "Project-Id-Version: matrix-docker-ansible-deploy \n" "Report-Msgid-Bugs-To: \n" "POT-Creation-Date: 2024-12-16 12:05+0900\n" "PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n" "Last-Translator: FULL NAME \n" "Language: jp\n" "Language-Team: jp \n" "MIME-Version: 1.0\n" "Content-Type: text/plain; charset=utf-8\n" "Content-Transfer-Encoding: 8bit\n" "Generated-By: Babel 2.16.0\n" #: ../../../docs/configuring-playbook-backup-borg.md:1 msgid "Setting up BorgBackup (optional)" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:3 msgid "" "The playbook can install and configure " "[BorgBackup](https://www.borgbackup.org/) (short: Borg) with " "[borgmatic](https://torsion.org/borgmatic/) for you." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:5 msgid "" "BorgBackup is a deduplicating backup program with optional compression " "and encryption. That means your daily incremental backups can be stored " "in a fraction of the space and is safe whether you store it at home or on" " a cloud service." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:7 msgid "" "You will need a remote server where BorgBackup will store the backups. " "There are hosted, BorgBackup compatible solutions available, such as " "[BorgBase](https://www.borgbase.com)." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:9 msgid "" "The backup will run based on `backup_borg_schedule` var (systemd timer " "calendar), default: 4am every day." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:11 msgid "" "By default, if you're using the integrated Postgres database server (as " "opposed to [an external Postgres server](configuring-playbook-external-" "postgres.md)), backups with BorgBackup 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 BorgBackup using the `backup_borg_postgresql_enabled` " "variable." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:13 msgid "" "**Note**: the component is not managed by this repository but its [own " "repository](https://github.com/mother-of-all-self-hosting/ansible-role-" "backup_borg)." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:15 msgid "Prerequisites" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:17 msgid "" "If you do not disable Postgres-backup support, make sure that the " "Postgres version of your homeserver's database is compatible with " "borgmatic." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:19 msgid "Create a new SSH key:" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:25 msgid "" "This can be done on any machine and you don't need to place the key in " "the `.ssh` folder. It will be added to the Ansible config later." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:27 msgid "" "Add the **public** part of this SSH key (the `matrix-borg-backup.pub` " "file) to your BorgBackup provider/server:" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:29 msgid "" "If you plan to use a hosted solution, follow their instructions. If you " "have your own server, copy the key over:" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:39 msgid "Adjusting the playbook configuration" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:41 msgid "" "Minimal working configuration " "(`inventory/host_vars/matrix.example.com/vars.yml`) to enable BorgBackup:" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:58 msgid "where:" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:60 msgid "USER - SSH user of a provider/server" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:61 msgid "HOST - SSH host of a provider/server" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:62 msgid "" "REPO - BorgBackup repository name, it will be initialized on backup " "start, eg: `matrix`, regarding Syntax see [Remote " "repositories](https://borgbackup.readthedocs.io/en/stable/usage/general.html" "#repository-urls)" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:63 msgid "" "PASSPHRASE - passphrase used for encrypting backups, you may generate it " "with `pwgen -s 64 1` or use any password manager" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:64 msgid "" "PRIVATE KEY - the content of the **private** part of the SSH key you " "created before. The whole key (all of its belonging lines) under " "`backup_borg_ssh_key_private` needs to be indented with 2 spaces" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:66 msgid "" "To backup without encryption, add `backup_borg_encryption: 'none'` to " "your vars. This will also enable the " "`backup_borg_unknown_unencrypted_repo_access_is_ok` variable." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:68 msgid "" "`backup_borg_location_source_directories` defines the list of directories" " to back up: it's set to `{{ matrix_base_data_path }}` by default, which " "is the base directory for every service's data, such as Synapse, Postgres" " and the bridges. You might want to exclude certain directories or file " "patterns from the backup using the " "`backup_borg_location_exclude_patterns` variable." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:70 msgid "" "Check the [backup_borg role](https://github.com/mother-of-all-self-" "hosting/ansible-role-backup_borg)'s " "[defaults/main.yml](https://github.com/mother-of-all-self-hosting" "/ansible-role-backup_borg/blob/main/defaults/main.yml) file for the full " "list of available options." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:72 msgid "Installing" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:74 msgid "" "After configuring the playbook, run it with [playbook tags](playbook-" "tags.md) as below:" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:81 msgid "" "The shortcut commands with the [`just` program](just.md) are also " "available: `just install-all` or `just setup-all`" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:83 msgid "" "`just install-all` is useful for maintaining your setup quickly ([2x-5x " "faster](../CHANGELOG.md#2x-5x-performance-improvements-in-playbook-" "runtime) than `just setup-all`) when its components remain unchanged. If " "you adjust your `vars.yml` to remove other components, you'd need to run " "`just setup-all`, or these components will still remain installed. Note " "these shortcuts run the `ensure-matrix-users-created` tag too." msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:85 msgid "Manually start a backup" msgstr "" #: ../../../docs/configuring-playbook-backup-borg.md:87 msgid "" "For testing your setup it can be helpful to not wait until 4am. If you " "want to run the backup immediately, log onto the server and run " "`systemctl start matrix-backup-borg`. This will not return until the " "backup is done, so possibly a long time. Consider using " "[tmux](https://en.wikipedia.org/wiki/Tmux) if your SSH connection is " "unstable." msgstr ""