summaryrefslogtreecommitdiff
path: root/README.md
blob: daf2a5b138b890163d7f601f7b458b30cd3893f4 (plain)
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
# Data migration plugin

This plugin exports and imports *all* articles of a specific user using a neutral format (JSON files in a ZIP archive). This way you can migrate your entire article dataset between different tt-rss instances even if they are not sharing a common database backend, i.e. MySQL to PostgreSQL.

Note that this only migrates articles. You can transfer your tt-rss settings and feed subscriptions via OPML import/export before migrating data with this plugin.

Migrating between different tt-rss versions might work but is not recommended.

Plugin is in development, I suggest testing your import first on a separate test user (or database) for the time being.

### Using the plugin

1. Use plugin installer in preferences or git checkout manually to ``plugins.local/data_migration``
2. Enable plugin in ``config.php`` by adding ``data_migration`` to ``PLUGINS`` directive
3. Plugin-specific options should appear in ``update.php`` help output (``php ./update.php --help``)

#### Exporting data

```
php ./update.php --data_user test --data_export articles-of-user-test.zip
```

#### Importing data

```
php ./update.php --data_user test --data_import articles-of-user-test.zip
```