auberge 0.11.0

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
110

# 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  |
| -o, --output FORMAT | Output format (`human`, `json`) | `human`   |

## 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 --output json
```

## Output Example

```
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 Output

```bash
auberge backup list --output 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
  }
]
```

JSON goes to stdout; human-format chrome (banners, info messages) goes to stderr.

**Schema**

| Field      | Type   | Description                              |
| ---------- | ------ | ---------------------------------------- |
| host       | string | Host the backup was taken from           |
| app        | string | Application name                         |
| timestamp  | string | Backup timestamp (`YYYY-MM-DD_HH-MM-SS`) |
| path       | string | Absolute path to the backup directory    |
| size_bytes | number | Backup size in bytes                     |

## 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)