blob: a3b23f44fa359cfa68bf386c1fd0f646dacdc51f (
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
28
29
30
31
32
33
34
35
36
|
# Data migration plugin
This plugin exports and imports *all* articles of a specific user via 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 the plugin globally](https://tt-rss.org/wiki/GlobalConfig) by adding ``data_migration`` to ``PLUGINS`` directive;
3. Plugin-specific options should appear in ``update.php`` help output (``php ./update.php --help``);
#### Exporting data
Using docker compose:
```
docker compose exec -u app -w /var/www/html/tt-rss app php82 ./update.php --data_user test --data_export /tmp/test.zip
docker compose cp app:/tmp/test.zip .
```
On the host:
```
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
```
|