Frequently Asked Questions

Table of Contents:

Why are you not merging my pull-request?

List of things to avoid:

Why are you not developing my feature request?

Feature X was available in Miniflux v1?

Miniflux 2 doesn’t try to reimplement all features of Miniflux 1. The minimalist approach is pushed a little bit further.

If you really miss something, you must contribute to the project, but remember, you have to keep the minimalist philosophy of Miniflux.

Why Miniflux stores favicons into the database?

Miniflux follows the the Twelve Factors principle. Nothing is stored on the local file system. The application is designed to run on ephemeral containers without persistent storage.

How to create themes for Miniflux 2?

As of now, Miniflux 2 doesn’t have any mechanism to load external stylesheets to avoid dependencies. Themes are embedded into the binary.

If you would like to submit a new official theme, you must send a pull-request. But do not forget that you will have to maintain your theme over the time, otherwise, your theme will be removed from the code base.

Why there is no plugin system?

What is "Save this article"?

“Save” sends the feed entry to third-party services like Pinboard or Instapaper if configured.

How are items removed from the database?

Entry status in the database follows this flow: read -> unread -> removed.

Entries marked as removed are not visible in the web UI. They are deleted from the database only when they are no longer visible in the original feed.

Entries marked as favorites are never deleted (column starred in the entries table).

Data retention is also controlled with the variables CLEANUP_ARCHIVE_UNREAD_DAYS and CLEANUP_ARCHIVE_READ_DAYS.

Keep in mind that Postgres needs to run the VACUUM command to reclaim disk space.

What "Flush History" does?

“Flush History” changes the status of entries from “read” to “removed” (except for bookmarks). Entries with the status “removed” are not visible in the user interface.

Which binary do I need to use on my Raspberry Pi?

Raspberry Pi ModelMiniflux Binary
A, A+, B, B+, Zerominiflux-linux-armv6 (32 bits)
2 and 3miniflux-linux-armv7 (32 bits)
3 and 4miniflux-linux-arm64 (64 bits)

Which Debian package architecture should I use for my Raspberry Pi?

Raspberry Pi ModelDebian Package Architecture
A, A+, B, B+, ZeroNot supported yet
2 and 3armhf (32 bits)
3 and 4arm64 (64 bits)

Which binary do I need to use on Scaleway ARM machines?

Server TypeMiniflux Binaryuname -m
Scaleway C1miniflux-linux-armv6armv7l
Scaleway ARM64miniflux-linux-armv8aarch64

Which Docker architecture should I use?

Pulling the latest tag or a specific version should download the correct image according to your machine.

Docker Architectureuname -mExample
amd64x86_64
arm32v6armhfRaspberry Pi
arm32v6armv7lScaleway C1
arm64v8aarch64Scaleway ARM64

If you use the wrong architecture, Docker will returns an error like this one:

standard_init_linux.go:178: exec user process caused "exec format error"

Multi-arch Docker images are available only since Miniflux 2.0.12.

Why SQL migrations are not executed automatically?

How to backup my data?

Refer to the official Postgres documentation for details about backing up and restoring a Postgres database.

Basic SQL dump example:

# Backup
pg_dump miniflux2 -f miniflux.dump

# Restore
psql miniflux2 < miniflux.dump

There many other options available, refer to the official documentation of pg_dump and pg_restore.