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
130
131
132

# auberge backup import-opml

Import OPML file to FreshRSS

## Synopsis

```bash
auberge backup import-opml [OPTIONS] --input <FILE>
# Alias: auberge b io
```

## Description

Imports feed subscriptions from an OPML file into FreshRSS. Useful for:

- Restoring feed subscriptions from backup
- Migrating from another RSS reader
- Bulk adding feeds

## Options

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

## Examples

```bash
# Import feeds (interactive host selection)
auberge backup import-opml --input feeds.opml

# Specific host
auberge backup import-opml --host myserver --input freshrss-backup.opml

# Specific user
auberge backup import-opml --host myserver --input feeds.opml --user john

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

## Process

1. **Upload OPML file** to /tmp/ on remote host
2. **Run FreshRSS CLI import** command
3. **Clean up** temporary file
4. **Display results**

## Output Example

```
Using SSH key: ~/.ssh/identities/ansible_myserver
Importing OPML to FreshRSS
  Host: myserver
  User: admin
  Input: feeds.opml

  Uploading OPML file...
  Importing feeds...

Imported 47 feeds in 3 categories
✓ OPML imported successfully
```

## Supported OPML Format

Standard OPML 2.0 format:

```xml
<?xml version="1.0" encoding="UTF-8"?>
<opml version="2.0">
  <head><title>Feed List</title></head>
  <body>
    <outline text="Category Name">
      <outline type="rss" text="Feed Name" xmlUrl="https://example.com/feed"/>
    </outline>
  </body>
</opml>
```

## Import Behavior

- **Existing feeds**: Skipped (not duplicated)
- **Categories**: Created if they don't exist
- **Feed errors**: Reported but don't stop import

## Use Cases

**Restore from export**:

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

**Migrate from other readers**: Export OPML from Feedly, Inoreader, etc., then import

**Bulk add feeds**: Create OPML file with multiple feeds and import at once

## Troubleshooting

**File not found**:

- Check file path is correct
- Use absolute path or ensure file is in current directory

**Import fails**:

- Verify OPML format is valid XML
- Check FreshRSS is running: `ssh user@host 'systemctl status freshrss'`
- Check FreshRSS logs: `ssh user@host 'journalctl -u freshrss'`

**User not found**:

- Verify username exists in FreshRSS
- Default user is 'admin'

## Related Commands

- [auberge backup export-opml](export-opml.md) - Export FreshRSS feeds
- [auberge backup restore](restore.md) - Full FreshRSS restore

## See Also

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