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

OPML Import

If you don’t care about your previous data, export your feeds from Miniflux 1.x in OPML and import them into Miniflux 2.

Migration Script

There is a migration script in the archived repository: scripts/migrate-v2.php.

Step 1

Make sure 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 into 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 Miniflux 2 database as argument. Adjust the parameters to your own environment.

Migration from v1.1 to v1.2

To import your old database to 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).