auberge 0.8.5

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
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109

# auberge backup list

List available backups

## Synopsis

```bash
auberge backup list [OPTIONS]
```

## Alias

`auberge b ls`

## Description

Lists all available backups with filtering options. Shows host, application, timestamp, and size information.

## Options

| Option              | Description                      | Default   |
| ------------------- | -------------------------------- | --------- |
| -H, --host HOST     | Filter by host                   | All hosts |
| -a, --app APP       | Filter by application            | All apps  |
| -f, --format FORMAT | Output format: table, json, yaml | table     |

## Examples

```bash
# List all backups
auberge backup list

# Filter by host
auberge backup list --host myserver

# Filter by application
auberge backup list --app baikal

# Combine filters
auberge backup list --host myserver --app freshrss

# JSON output
auberge backup list --format json

# YAML output
auberge backup list --format yaml
```

## Output Formats

**Table** (default):

```
HOST       APP        TIMESTAMP            SIZE
myserver   baikal   2024-01-27_14-30-00  2.3 MB
myserver   freshrss   2024-01-27_14-30-00  15.7 MB
myserver   navidrome  2024-01-27_14-30-00  45.2 KB
devbox     baikal   2024-01-26_10-15-30  1.8 MB

Total: 4 backup(s)
```

**JSON**:

```json
[
  {
    "host": "myserver",
    "app": "baikal",
    "timestamp": "2024-01-27_14-30-00",
    "path": "/home/user/.local/share/auberge/backups/myserver/2024-01-27_14-30-00/baikal",
    "size_bytes": 2411520
  }
]
```

**YAML**:

```yaml
- host: myserver
  app: baikal
  timestamp: 2024-01-27_14-30-00
  path: /home/user/.local/share/auberge/backups/myserver/2024-01-27_14-30-00/baikal
  size_bytes: 2411520
```

## Backup Organization

Backups are stored in timestamp-first structure:

```
~/.local/share/auberge/backups/
└── myserver/
    ├── 2024-01-27_14-30-00/
    │   ├── baikal/
    │   ├── freshrss/
    │   └── navidrome/
    └── 2024-01-26_10-15-30/
        └── baikal/
```

## Related Commands

- [auberge backup create](create.md) - Create new backup
- [auberge backup restore](restore.md) - Restore from backup

## See Also

- [Backup and Restore](../../backup-restore/README.md)