auberge 0.8.6

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

# auberge backup export-opml

Export FreshRSS feeds to OPML file

## Synopsis

```bash
auberge backup export-opml [OPTIONS] --output <FILE>
# Alias: auberge b eo
```

## Description

Exports FreshRSS feed subscriptions to an OPML file for backup or migration to other RSS readers.

OPML (Outline Processor Markup Language) is a standard format for RSS feed lists, compatible with most feed readers.

## Options

| Option             | Description                      | Default                         |
| ------------------ | -------------------------------- | ------------------------------- |
| -H, --host HOST    | Target host                      | Interactive selection           |
| -o, --output FILE  | Output OPML file path (required) | None                            |
| -k, --ssh-key PATH | SSH private key                  | ~/.ssh/identities/{user}_{host} |
| --user USER        | FreshRSS username                | admin                           |

## Examples

```bash
# Export feeds (interactive host selection)
auberge backup export-opml --output feeds.opml

# Specific host
auberge backup export-opml --host myserver --output freshrss-backup.opml

# Specific user
auberge backup export-opml --host myserver --output feeds.opml --user john

# Custom SSH key
auberge backup export-opml --host myserver --output feeds.opml --ssh-key ~/.ssh/custom_key
```

## Output Example

```
Using SSH key: ~/.ssh/identities/ansible_myserver
Exporting OPML from FreshRSS
  Host: myserver
  User: admin
  Output: feeds.opml

✓ OPML exported successfully
  Saved to: feeds.opml
```

## OPML File Format

```xml
<?xml version="1.0" encoding="UTF-8"?>
<opml version="2.0">
  <head>
    <title>FreshRSS Feeds</title>
  </head>
  <body>
    <outline text="Tech" title="Tech">
      <outline type="rss" text="Hacker News" xmlUrl="https://news.ycombinator.com/rss"/>
      <outline type="rss" text="TechCrunch" xmlUrl="https://techcrunch.com/feed/"/>
    </outline>
    <outline text="News" title="News">
      <outline type="rss" text="BBC News" xmlUrl="http://feeds.bbci.co.uk/news/rss.xml"/>
    </outline>
  </body>
</opml>
```

## Use Cases

**Backup**: Regular export of feed subscriptions

```bash
auberge backup export-opml --output ~/backups/freshrss-$(date +%Y-%m-%d).opml
```

**Migration**: Export from one server to import on another

```bash
# Export from old server
auberge backup export-opml --host oldserver --output feeds.opml

# Import to new server
auberge backup import-opml --host newserver --input feeds.opml
```

**Portability**: Import into other RSS readers (Feedly, Inoreader, etc.)

## Related Commands

- [auberge backup import-opml](import-opml.md) - Import OPML file to FreshRSS
- [auberge backup create](create.md) - Full FreshRSS backup

## See Also

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