diff options
| author | Colin Wilk <colin@wilk.cx> | 2026-06-28 22:47:11 +0200 |
|---|---|---|
| committer | Colin Wilk <colin@wilk.cx> | 2026-06-28 23:18:35 +0200 |
| commit | 7d96c1a11fc442b4efddf9ce5250cf0a9dfaf02e (patch) | |
| tree | 5561dbeee61aaab05e21f3bc2895ff703a2ce137 /README.md | |
| parent | 785e6c88e4c0a3ccc44fd357b4f693c5aadd432c (diff) | |
| download | ansible-role-borgbackup-7d96c1a11fc442b4efddf9ce5250cf0a9dfaf02e.tar.gz ansible-role-borgbackup-7d96c1a11fc442b4efddf9ce5250cf0a9dfaf02e.zip | |
Parametrize server-side borg user
Adds option to choose a non-default borg backup user on the server.
Diffstat (limited to 'README.md')
| -rw-r--r-- | README.md | 19 |
1 files changed, 15 insertions, 4 deletions
@@ -91,14 +91,25 @@ borg_server_host_ssh_key: "" # Required borg_server_host_url: { { borg_server_host } } # Optional ``` -The role creates a user for the Borg repositories on the Borg server. You can -specify the location of the home directory with `borg_server_user_home`, which -will also be the location for the backups. +By default, the role uses the `borg` user on the backup server and creates it +automatically. To use a different user, set `borg_server_user`: ```yaml -borg_server_user_home: /opt/borg +borg_server_user: backupserver +borg_server_user_home: /var/backups ``` +The `borg_server_user_home` specifies the home directory of the borg user on +the server. All client repositories will be saved in this directory. + +To disable automatic user creation (when the user is managed externally), set: + +```yaml +borg_server_user_create: false +``` + +When disabled, the user must exist before running the role. + For the backup itself, there are a few Borg parameters you can configure. Not all options that Borg offers are available in the Ansible role yet. For more configuration options, see <https://borgbackup.readthedocs.io>. |