auberge 0.14.15

CLI tool for managing self-hosted infrastructure with Ansible
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32

# auberge sync music

Synchronize a local music directory to `/srv/music` on a remote host. Alias: `auberge sy m`.

```bash
auberge sync music [OPTIONS]
```

Uses `rsync -avzP --delete`, mirroring local state (remote files not present locally are deleted). Excludes `.DS_Store` and `*.tmp`. SSH key: `~/.ssh/identities/ansible_{host}`.

## Options

| Option              | Description             | Default     |
| ------------------- | ----------------------- | ----------- |
| `-H, --host HOST`   | Target host             | Interactive |
| `-s, --source PATH` | Source music directory  | `~/Music`   |
| `-n, --dry-run`     | Preview without syncing | false       |

## Examples

```bash
auberge sync music --host myserver
auberge sync music --host myserver --source /mnt/media/music
auberge sync music --host myserver --dry-run
```

## Gotchas

- `--delete` removes remote files that no longer exist locally — run `--dry-run` before the first sync of a large library.
- Ansible user requires write access to `/srv/music` (created by the Navidrome Ansible role). Verify: `ssh ansible@host 'touch /srv/music/test && rm /srv/music/test'`.
- Missing SSH key: run `auberge ssh keygen --host myserver --user ansible` first.
- To force a Navidrome rescan: `ssh ansible@host 'sudo systemctl restart navidrome'`.