[Web][Restic][Dovecot][Dockerapi] Add restic backups with restore in the UI

- Scheduled, encrypted backups to S3, SFTP, REST or a local folder (new restic-mailcow container)
- Restore of mailboxes and whole domains in the UI, also deleted ones, for admins and domain admins
- Scope set by RESTIC_BACKUP_MODE in mailcow.conf (all, data, config)
- Optional backup before updates (update.sh), helper-scripts/restic.sh for a full restore
This commit is contained in:
FreddleSpl0it committed 2026-11-08 22:56:27 +01:00
1 parent a64ee13670
commit 6cf0390d58
66 files changed
+15214 -97

No files matched your search

+369
View File
@@ -503,6 +503,346 @@
"syncjob_max_kb_per_second": "Bandwidth limit per process (KB/s)",
"syncjob_max_kb_per_second_info": "0 = unlimited. Caps every sync process in KB/s; a per-job limit (bytes/s) is capped by this. Total ≈ this × max parallel."
},
"backup": {
"active_line": "%s #%s – %s",
"added": "Added",
"advanced": "Advanced",
"advanced_info": "prune, unused space, check, index, upload limit",
"all_items": "All items",
"all_ticked": "All mailboxes selected –",
"and_more": "and %s more",
"backup_now": "Back up now",
"backup_now_info": "Backs up now, independent of the schedule.",
"cancel": "Cancel",
"cancel_job": "Cancel job",
"cancel_running_confirm": "Cancel the running job? Anything restored so far is kept.",
"check_info": "Verifies the repository and reads a part of the data, as after the first scheduled backup of a day.",
"check_now": "Check",
"check_subset": "Full check in",
"check_subset_info": "After the first scheduled backup of a day 1/N of the data is read, so all of it once in N backup days.",
"check_subset_unit": "backup days (0 = off)",
"clear_selection": "Clear selection",
"close": "Close",
"collapse": "Hide the mailboxes of %s",
"component": "Item",
"component_aliases": "Aliases",
"component_app_passwords": "App passwords",
"component_bcc": "BCC maps",
"component_domain": "Domain",
"component_filters": "Filters and Sieve scripts (incl. vacation reply)",
"component_groups": "Group memberships",
"component_imap_acl": "IMAP shares (folder permissions)",
"component_mail_policies": "Mail policies (assignments)",
"component_mailbox": "Mailbox",
"component_mails": "Mails with folders and flags",
"component_password": "Mailbox password from the backup",
"component_retention_rules": "Retention rules (assignments)",
"component_sender_acl": "Sender permissions (send as)",
"component_settings": "Mailbox settings",
"component_sieve_activate": "Activate the Sieve script of the backup if none is active",
"component_sogo": "Reset calendars and contacts to the backup",
"component_sogo_new": "Calendars and contacts",
"component_spam": "Spam settings (deny/allowlist, spam score, spam aliases)",
"component_syncjobs": "Sync jobs",
"component_tfa": "Two-factor authentication",
"components": "Items",
"connection_ok": "Connection OK",
"content_unavailable": "This snapshot has no list of its mailboxes (made before mailcow kept one): only domains and mailboxes that exist now can be restored.",
"copy": "Copy",
"count_deleted": "%s (%s deleted)",
"create_note": "Deleted mailboxes and domains are created again from the backup, with the password from the backup.",
"created": "Created",
"created_from_backup": "Created from the backup",
"data_added": "Added",
"deleted_domain_children": "The domain was deleted: only the whole domain can be restored.",
"details": "Details",
"domains": "Domains",
"duration": "Duration",
"enabled": "Schedule",
"enabled_label": "Active",
"error": "Error",
"errors": "Errors",
"expand": "Show the mailboxes of %s",
"failed_line": "%s #%s failed",
"finished": "Finished",
"first_run": "Setup",
"first_run_1": "Choose and fill in the backup target",
"first_run_2": "Generate the repository password and store it outside of mailcow",
"first_run_3": "Save the changes",
"first_run_4": "\"Test connection\" (creates the repository)",
"first_run_5": "Switch the schedule on and save",
"group_access": "Access",
"group_addresses": "Addresses and memberships",
"group_calendar": "Calendars and contacts",
"group_filters": "Filters and spam",
"group_mail": "Mails",
"hostname": "Host",
"id": "ID",
"include_fts": "Including the full-text search index",
"include_index": "Back up the Dovecot index (faster restore, it can be rebuilt as well)",
"intro": "Encrypted daily backups with restic. Restore:",
"intro_restore_link": "E-Mail › Restore",
"job": "Job #%s",
"jobs": "Jobs",
"jobs_none": "No jobs yet",
"keep": "Keep snapshots",
"keep_daily": "daily",
"keep_hourly": "hourly",
"keep_info": "How many hourly, daily, weekly, monthly and yearly snapshots are kept; older ones are forgotten after each backup. Of several backups a day only the last one is kept as daily, \"hourly\" keeps the others too.",
"keep_monthly": "monthly",
"keep_weekly": "weekly",
"keep_yearly": "yearly",
"limit_upload": "Upload limit",
"limit_upload_info": "0 = unlimited",
"load_error": "The backup data could not be loaded",
"local_path": "Directory",
"local_path_info": "Subdirectory below RESTIC_LOCAL_PATH of mailcow.conf (empty: the Docker volume restic-repo-vol-1). It does not protect against the loss of the server.",
"log": "Log",
"log_empty": "No log entries yet",
"mail_target": "Mails",
"mail_target_folder": "into a separate folder \"%s\"",
"mail_target_folder_name": "Restored <date of the snapshot>",
"mail_target_folder_named": "separate folder \"%s\"",
"mail_target_folder_short": "separate folder",
"mail_target_original": "into the original folders (missing mails only)",
"mail_target_original_short": "original folders",
"mailboxes": "Mailboxes",
"maintenance": "Maintenance",
"manual_by": "manual: %s",
"max_unused": "Max. unused space",
"max_unused_info": "The prune may leave up to this share of unused data in the repository and rewrites less (restic --max-unused).",
"minutes_ago": "%s min ago",
"modal_title_domain": "Restore domain %s",
"modal_title_mailbox": "Restore %s",
"modal_title_mailboxes": "Restore %s mailboxes in %s",
"mode_config": "Without mails (RESTIC_BACKUP_MODE=config)",
"mode_data": "Of the mailcow directory only mailcow.conf (RESTIC_BACKUP_MODE=data)",
"mode_invalid": "RESTIC_BACKUP_MODE in mailcow.conf is invalid (%s), allowed are all, data and config. Backups fail.",
"more": "More",
"more_items": "+ %s more",
"name": "Name",
"nav": "Restore",
"no_components": "Choose at least one item.",
"no_domains": "The snapshot contains no domains you can restore.",
"no_mail_data": "This snapshot holds no mails (RESTIC_BACKUP_MODE=config): mails, IMAP shares, calendars and contacts and the Sieve activation cannot be restored.",
"no_mailboxes": "The snapshot contains no mailboxes of this domain.",
"no_matches": "Nothing matches the search.",
"no_snapshots_any": "There are no snapshots yet.",
"no_snapshots_backup_now": "Back up now (System › Configuration › Backup)",
"not_configured": "Backups are not set up.",
"not_configured_da": "Backups are not set up. Please contact the administrator.",
"note_app_passwords": "Old app passwords give access again.",
"note_inactive": "Inactive mailboxes do not get mails, IMAP shares and Sieve scripts back.",
"note_retention_rules": "A retention rule can delete older restored mails on its next run.",
"note_settings": "Quota, protocols, attributes, permissions, Pushover, relayhost (tags are added)",
"note_sieve_activate": "It may forward mails or send vacation replies again.",
"note_sogo": "Existing calendars, address books and SOGo settings get the state of the backup.",
"note_sogo_more": "Missing calendars, address books and entries come back. Names and shares of existing calendars and address books and all SOGo settings (signatures, identities, subscriptions, view) are replaced by those of the backup. Entries changed since are kept.",
"note_tfa": "The login needs the old second factor again.",
"notify_email": "Notify on errors",
"notify_email_info": "Addresses separated by commas; they get a mail when a job fails.",
"only_deleted": "Deleted only",
"optional": "optional",
"overwrite": "Overwrites current values",
"overwrite_confirm": "%s will be overwritten with the state of the backup for %s mailbox(es). Continue?",
"overwrite_info": "These items replace the current values with those of the backup.",
"overwrite_short_password": "password",
"overwrite_short_settings": "settings",
"overwrite_short_sogo": "calendars and contacts",
"password": "Repository password",
"password_change": "A new password only works for a new, empty repository: an existing one keeps its password.",
"password_confirmed": "I have stored the repository password outside of mailcow. Without it the backup cannot be restored.",
"password_confirmed_short": "Stored outside of mailcow (required)",
"password_generate": "Generate",
"password_info": "At least 8 characters, it is not shown again.",
"password_unconfirmed": "Backups do not run before you confirm below that the repository password is stored outside of mailcow.",
"prune_confirm": "Prune now? The data of snapshots that are no longer kept is deleted from the repository.",
"prune_info": "Deletes the data of snapshots that are no longer kept.",
"prune_now": "Prune",
"prune_weekday": "Prune on",
"prune_weekday_info": "Once a week, after the first scheduled backup from this day on, data no longer needed is deleted from the repository. \"Never\" suits append-only or object-lock targets.",
"queued_inline": "Restore job #%s queued.",
"refresh": "Refresh",
"repo_not_tested": "The repository has not been tested yet: use \"Test connection\".",
"requested_admin": "Administrator",
"requested_by": "Requested by",
"requested_by_short": "by %s",
"requested_schedule": "Schedule",
"rest_password": "Password",
"rest_url": "URL",
"rest_url_info": "e.g. https://backup.example.org:8000/mailcow, without user and password.",
"rest_user": "User",
"restore": "Restore",
"restore_added_many": "Restore job #%s queued for %s mailboxes",
"restore_added_one": "Restore job #%s queued for %s mailbox",
"restore_background": "The restore runs in the background. Its progress is shown in \"Previous restores\".",
"restore_card": "Restore from backup",
"restore_info": "Only what is missing is added. Nothing that exists is overwritten or deleted, except the items marked below.",
"restore_item": "Restore %s",
"restore_overwrite": "Restore and overwrite",
"restore_target_domain": "All mailboxes of the domain %s",
"restore_target_domain_short": "Domain %s",
"restore_target_mailbox": "Mailbox %s",
"restore_target_mailboxes": "%s mailboxes: %s",
"restore_target_mailboxes_of": "%s mailboxes of %s",
"restore_title": "Restore from backup",
"restore_what": "Selection",
"restores": "Previous restores",
"restores_info": "Restores of the last 180 days. \"Details\" shows the result per mailbox and item. Running restores can be cancelled until the mails are restored.",
"restores_none": "No restores yet",
"result": "Result",
"result_activated": "Activated script",
"result_details": "Details",
"result_empty": "no result",
"result_errors": "Errors: %s",
"result_failed": "with errors: %s",
"result_folder": "Folder",
"result_folders": "Folders",
"result_folders_created": "Folders created",
"result_folders_failed": "Folders with errors",
"result_mailboxes": "Mailboxes: %s",
"result_none": "no result yet",
"result_note_no_mails": "The snapshot has no mails of this mailbox.",
"result_note_no_sogo_data": "The snapshot has no SOGo data of this mailbox.",
"result_subscribed": "Subscriptions added",
"result_summary": "%s added, %s already present",
"result_unchanged": "Unchanged: %s",
"runner_missing": "The backup container (restic-mailcow) has not reported since %s. Backups and restores do not run until it is running again.",
"runner_never": "The backup container (restic-mailcow) has not reported yet. Backups and restores do not run until it is running.",
"s3_access_key": "Access key",
"s3_bucket": "Bucket",
"s3_endpoint": "Endpoint",
"s3_endpoint_info": "URL with https://, e.g. https://s3.eu-central-1.amazonaws.com or the URL of an S3-compatible storage.",
"s3_path": "Path in the bucket",
"s3_path_style": "Path-style access (needed by some S3-compatible storages, e.g. MinIO)",
"s3_region": "Region",
"s3_secret_key": "Secret key",
"save": "Save changes",
"schedule": "Schedule",
"schedule_add": "Add",
"schedule_at": "at",
"schedule_daily": "daily",
"schedule_days": "Weekdays",
"schedule_entry": "%s – %s",
"schedule_none": "No times set.",
"schedule_remove": "Remove",
"schedule_time": "Time",
"schedule_time_info": "Time zone: %s (TZ in mailcow.conf).",
"scope": "Scope",
"scope_all": "Everything",
"scope_all_in": "Mails, database, Redis, Rspamd, calendars and contacts, the whole mailcow directory",
"scope_config": "Configuration only",
"scope_config_in": "Database, Redis, mail crypt keys, mailcow.conf, data/conf",
"scope_config_out": "Mails, Rspamd, calendars and contacts",
"scope_data": "Data only",
"scope_data_in": "Mails, database, Redis, Rspamd, calendars and contacts, mailcow.conf",
"scope_data_out": "The rest of the mailcow directory, e.g. data/conf and data/web",
"scope_domain": "whole domain",
"scope_info": "Set with RESTIC_BACKUP_MODE in mailcow.conf (all, data or config), it cannot be changed in the UI. After a change: docker compose up -d.",
"scope_mailbox": "selected mailboxes",
"scope_unknown": "Not known yet: the backup container has not reported yet.",
"search_placeholder": "Search domain or mailbox (from 2 characters)",
"search_truncated": "More than 500 hits: refine the search.",
"seconds_ago": "%s s ago",
"secret_keep": "Stored. Leave empty to keep it.",
"secrets_error": "The stored credentials cannot be decrypted (e.g. after a restore on another server). Please enter the repository password and the credentials again.",
"select_whole_domain": "select the whole domain",
"selected_domain": "Whole domain %s",
"selected_mailbox_in": "%s mailbox in %s",
"selected_mailboxes_in": "%s mailboxes in %s",
"selection_none": "Nothing selected",
"selection_replaced": "A restore covers one domain: the selection in %s was replaced.",
"selection_reset": "The list was updated after a finished restore; the selection was cleared.",
"settings": "Settings",
"sftp_host": "Host",
"sftp_host_key": "Host key of the server",
"sftp_host_key_info": "Accepted at the first connection and checked from then on. It is forgotten when host or port change.",
"sftp_path": "Path",
"sftp_path_info": "Directory of the repository on the server, relative to the home directory of the user or absolute.",
"sftp_port": "Port",
"sftp_public_key": "Public key of mailcow",
"sftp_public_key_info": "mailcow logs in with this key. Add it to ~/.ssh/authorized_keys of the user on the SFTP server.",
"sftp_public_key_missing": "The backup container creates the key when it starts.",
"sftp_user": "User",
"show_more": "Show %s more (%s left)",
"show_more_domains": "Show %s more domains (%s left)",
"size": "Data",
"skipped": "Already present",
"snapshot": "Snapshot",
"snapshot_label": "Backup point (snapshot)",
"snapshot_mode_config": "without mails",
"snapshot_mode_data": "data only",
"snapshots": "Snapshots",
"snapshots_none": "No snapshots yet",
"started": "Started",
"state": "State",
"state_cancelled": "Cancelled",
"state_done": "Done",
"state_failed": "Failed",
"state_queued": "Queued",
"state_running": "Running",
"status_deleted": "deleted",
"status_last": "Last backup %s (%s)",
"status_never": "No backup yet",
"status_next": "next %s",
"status_restoring": "being restored",
"status_schedule_off": "schedule off",
"status_snapshot": "%s snapshot",
"status_snapshots": "%s snapshots",
"status_stale": "Backup overdue by the schedule (last success %s).",
"step_aliases": "restoring the aliases",
"step_backup": "uploading",
"step_check": "checking",
"step_connect": "connecting",
"step_domain": "creating the domain",
"step_dump": "database dump",
"step_export": "export of the domains",
"step_files": "restoring files",
"step_forget": "forgetting old snapshots",
"step_init": "creating the repository",
"step_mails": "waiting for the mail container",
"step_mails_done": "mails restored, finishing",
"step_mails_running": "restoring mails",
"step_prune": "pruning",
"step_settings": "restoring settings",
"step_snapshots": "reading the snapshots",
"step_sogo": "restoring calendars and contacts",
"step_stats": "repository size",
"summary_backup": "snapshot %s, %s added",
"summary_check": "part %s checked",
"summary_created": "repository created",
"summary_snapshots": "Snapshots: %s",
"tab": "Backup",
"target": "Backup target",
"target_count": "%s mailboxes in the snapshot, %s of them deleted",
"target_count_all": "%s mailboxes in the snapshot",
"target_count_one": "1 mailbox in the snapshot",
"target_count_one_deleted": "1 mailbox in the snapshot, deleted",
"target_local": "Local directory",
"target_rest": "restic REST server",
"target_s3": "S3 (Amazon S3 or S3-compatible)",
"target_sftp": "SFTP",
"test_connection": "Test connection",
"test_connection_info": "Checks the connection and creates the repository if it does not exist yet.",
"time": "Time",
"to_backup_settings": "Backup settings",
"type": "Type",
"type_backup": "Backup",
"type_check": "Check",
"type_init": "Connection test",
"type_prune": "Prune",
"type_restore": "Restore",
"warnings": "Warnings",
"weekday_0": "Sunday",
"weekday_1": "Monday",
"weekday_2": "Tuesday",
"weekday_3": "Wednesday",
"weekday_4": "Thursday",
"weekday_5": "Friday",
"weekday_6": "Saturday",
"weekday_never": "never (only manually)",
"will_be_created": "will be created"
},
"danger": {
"access_denied": "Access denied or invalid form data",
"alias_group_managed": "Alias %s belongs to a group and can only be changed there",
@@ -510,6 +850,31 @@
"api_key_description_invalid": "API key description must not exceed 255 characters",
"api_key_network_invalid": "Invalid IP address or network: %s",
"api_key_service_locked": "API key %s is defined in mailcow.conf and can only be changed there",
"backup_action_invalid": "Invalid backup endpoint action",
"backup_component_denied": "You may not restore %s",
"backup_component_requires": "%s needs %s as well",
"backup_components_invalid": "Invalid or missing restore component: %s",
"backup_components_no_mails": "The snapshot holds no mails (RESTIC_BACKUP_MODE=config), cannot restore: %s",
"backup_domain_not_in_snapshot": "The snapshot does not contain the domain %s",
"backup_entries_exceeded": "Too many entries (at most %s)",
"backup_export_invalid": "The export in the snapshot is missing or invalid",
"backup_job_active": "A job of the type %s is already queued or running",
"backup_job_busy": "The job is being processed by another request, try again",
"backup_job_not_cancellable": "Job #%s is no longer queued and cannot be cancelled",
"backup_job_not_running": "The restore job is not running",
"backup_job_type_invalid": "Invalid job type %s",
"backup_mail_target_invalid": "Invalid target for the mails (folder or original)",
"backup_mailbox_not_found": "Mailbox %s does not exist",
"backup_mailboxes_empty": "No mailboxes to restore",
"backup_mailboxes_one_domain": "All mailboxes of a restore must belong to one domain",
"backup_not_configured": "Backup target and repository password are not configured completely",
"backup_password_not_confirmed": "Confirm first that the repository password is stored outside of mailcow",
"backup_password_too_short": "The repository password must have at least %s characters",
"backup_restore_active": "A restore of %s is already queued or running",
"backup_scope_invalid": "Invalid restore scope (mailbox or domain)",
"backup_secrets_key_missing": "The backup container has not provided its key yet: start it (restic-mailcow) and save again",
"backup_setting_invalid": "Invalid value for %s",
"backup_snapshot_not_found": "Snapshot %s not found",
"group_address_invalid": "Group address %s is invalid or not in the domain of the group",
"group_description_invalid": "The group description must not exceed 255 characters",
"group_grant_invalid": "Invalid share for mailbox %s",
@@ -1446,6 +1811,10 @@
"app_links": "Saved changes to app links",
"app_passwd_added": "Added new app password",
"app_passwd_removed": "Removed app password ID %s",
"backup_job_added": "%s job #%s queued",
"backup_job_cancelled": "Job #%s cancelled",
"backup_restore_added": "Restore job #%s queued for %s mailbox(es)",
"backup_settings_saved": "Backup settings saved",
"bcc_deleted": "BCC map entries deleted: %s",
"bcc_edited": "BCC map entry %s edited",
"bcc_saved": "BCC map entry saved",