Migration from Older Versions
This page describes the migration procedures between major version changes in Miniflux.
Migration from v1.2 to v2 ¶
Miniflux 2.x is not backward compatible with Miniflux 1.x.
Differences between Miniflux 1.2 and Miniflux 2.0
- Miniflux 2 supports multiple attachments.
- Miniflux 2 uses categories instead of groups; only one category can be assigned to a feed.
- Miniflux 2 has fewer settings.
- Miniflux 2 doesn’t have a public RSS feed or cronjobs.
- Miniflux 2 doesn’t use API tokens anymore. For the Fever API, choose your own password, and for the REST API, use your account password.
- Miniflux 2 stores favicons in the database instead of using the local filesystem.
- Miniflux 2 themes are embedded in the application.
- Miniflux 2 doesn’t support RTL languages.
- Miniflux 2 supports only PostgreSQL.
- Miniflux 2 is written in Go (Golang) instead of PHP.
OPML Import
If you don’t need your previous data, export your feeds from Miniflux 1.x in OPML format and import them into Miniflux 2.
Migration Script
There is a migration script in the archived repository: scripts/migrate-v2.php.
- This script requires direct access to both the old and new databases.
- The first group linked to a feed will become the category associated with the imported feed.
- Only bookmarked items are migrated.
- Since entries are identified differently in Miniflux 2, you may have duplicate entries when refreshing your imported feeds.
Step 1
Ensure you are using the latest version of Miniflux 1.2.x.
Step 2
Install Miniflux 2 without creating any users. Create only the database schema (just run the migrations).
Step 3
Go to the Miniflux 1.2.x directory and run the script:
php scripts/migrate-v2.php --dsn="pgsql:host=localhost;dbname=miniflux2;user=postgres;password=postgres"
Destination is "pgsql:host=localhost;dbname=miniflux2;user=postgres;password=postgres"
* 2 user(s) to migrate
* Migrating user: #254 => #284
* Migrating integrations
* Migrating categories
* Migrating feeds
* Migrating entries
[...]
The script takes the PDO DSN of the Miniflux 2 database as an argument. Adjust the parameters to match your environment.
Migration from v1.1 to v1.2 ¶
To import your old database into the new database format, use this script:
php scripts/migrate-db.php --sqlite-db=/path/to/my/db.sqlite --admin=1
The script is located in the Git repository (not in the archive).