auberge 0.10.4

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
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129

# auberge dns list

List DNS records via Cloudflare

## Synopsis

```bash
auberge dns list [OPTIONS]
```

## Alias

`auberge d l`

## Description

Lists DNS records for your domain from Cloudflare. Displays A, AAAA, CNAME, MX, TXT, NS, and SRV records.

Requires `cloudflare_dns_api_token` and `domain` set in `config.toml`.

## Options

| Option               | Description                           | Default     |
| -------------------- | ------------------------------------- | ----------- |
| -s, --subdomain NAME | Filter by subdomain name              | All records |
| -o, --output FORMAT  | Output format (`human`, `json`)       | `human`     |
| -P, --production     | Use production API (default: sandbox) | false       |

## Configuration

Required values in `config.toml`:

- `cloudflare_dns_api_token`: Cloudflare API token with DNS read permissions
- `domain`: Your domain name

Configure with:

```bash
auberge config set cloudflare_dns_api_token your-token-here
auberge config set domain example.com
```

## Examples

```bash
# List all records
auberge dns list

# Filter by subdomain
auberge dns list --subdomain freshrss

# Production API
auberge dns list --production
```

## Output Example

```
CLOUDFLARE DNS
DNS Records for example.com

NAME                                     TYPE     CONTENT                  TTL
@                                        A        192.168.1.10             1
freshrss                                 A        192.168.1.10             1
baikal                                   A        192.168.1.10             1
www                                      CNAME    example.com              1
mail                                     MX       mail.example.com (10)    1
@                                        TXT      v=spf1 include:_...      1
```

## JSON Output

```bash
auberge dns list --output json
```

```json
[
  { "name": "@", "record_type": "A", "content": "192.168.1.10", "ttl": 1 },
  {
    "name": "freshrss",
    "record_type": "A",
    "content": "192.168.1.10",
    "ttl": 1
  },
  { "name": "www", "record_type": "CNAME", "content": "example.com", "ttl": 1 },
  {
    "name": "mail",
    "record_type": "MX",
    "content": "mail.example.com",
    "ttl": 1
  }
]
```

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

**Schema**

| Field       | Type   | Description                             |
| ----------- | ------ | --------------------------------------- |
| name        | string | Subdomain label (`@` for apex)          |
| record_type | string | DNS record type (A, AAAA, CNAME, MX, …) |
| content     | string | Record value (IP, hostname, text, …)    |
| ttl         | number | Time-to-live in seconds                 |

## Record Types

| Type  | Description    | Content Format              |
| ----- | -------------- | --------------------------- |
| A     | IPv4 address   | 192.168.1.10                |
| AAAA  | IPv6 address   | 2001:db8::1                 |
| CNAME | Canonical name | example.com                 |
| MX    | Mail exchange  | mail.example.com (priority) |
| TXT   | Text record    | "v=spf1..."                 |
| NS    | Name server    | ns1.cloudflare.com          |
| SRV   | Service        | target.example.com          |

## Related Commands

- [auberge dns status](status.md) - Show DNS status
- [auberge dns set](set.md) - Set A record
- [auberge dns migrate](migrate.md) - Migrate all records to new IP
- [auberge dns set-all](set-all.md) - Batch create A records

## See Also

- [DNS Management](../../dns/README.md)
- [Cloudflare Setup](../../getting-started/cloudflare.md)