Support custom arguments for borg create

1 files changed, 13 insertions, 0 deletions

diff --git a/README.md b/README.md
index 300a87b..6dff957 100644
--- a/README.md
+++ b/README.md
@@ -156,11 +156,24 @@ will be backed up by Borg.
 
 ```yaml
 borg_compression: zstd # -C argument
+borg_create_additional_arguments: "" # Additional borg create options
 borg_passphrase: "" # Env variable
 borg_included_dirs: [] # Positional arguments
 borg_excluded_dirs: [] # --exclude arguments
 ```
 
+`borg_create_additional_arguments` lets you pass additional options to `borg
+create`. These arguments are appended after all role-defined options, so
+user-specified options can override defaults. For example:
+
+```yaml
+# Add verbose output
+borg_create_additional_arguments: "--stats --list --filter=AME"
+
+# Stay in one filesystem and exclude caches
+borg_create_additional_arguments: "--one-file-system --exclude-caches"
+```
+
 To decrypt your backups without the client, we store the decryption keys in a
 YAML file in your Ansible repository. You require the decryption keys as well as
 access to the repository files on the Borg server to access the backups.