Frequently Asked Questions

Feature X was available in Miniflux 1?

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 are you not developing my feature request?

  • Developing a software takes a lot of time.
  • This is a free and open source project, no one owes you anything.
  • If you miss something, contribute to the project.
  • Don’t expect anyone to work for free.
  • As mentioned above, the number of features is voluntarily limited. Nobody likes bloatware.
  • Improving existing features is more important than adding new ones.

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?

  • Because this software has a minimalist approach.
  • Because implementing a plugin system increase the complexity of the software.
  • Because people do not maintain their plugins after a while.

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?

When a subscription is refreshed, entries marked as “removed” and not visible anymore in the XML feed are removed from the database.

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.

Is there any browser extensions for Miniflux?

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

  • Raspberry Pi A, A+, B, B+, Zero: miniflux-linux-armv6 compiled with GOARM=6
  • Raspberry Pi 2, 3: miniflux-linux-armv7 compiled with GOARM=7

Why there is no latest tag on the Docker image?

  • There is no latest tag to avoid people updating the software blindly to a new version without reading the ChangeLog and without looking to the possible breaking changes.
  • This is also to avoid people reporting bugs on the “latest” version, the latest tag is a moving target, this 2.0.4 today but it will be 2.0.5 another day. Having a bug reports that say “That doesn’t work with the latest version” doesn’t really help.
  • Latest tag or not, you still need to destroy the current container and start a new one with the desired image.
  • Using the latest tag is error-prone, it doesn’t mean you are on the latest version, especially if you forget to pull the image. By pinning the exact version you avoid surprises.

Why SQL migrations are not executed automatically?

  • Because it’s a source of problems.
  • Only one process should manipulate the database schema at once.
  • If you run multiple containers with an orchestrator that may cause issues.
  • You can still run the migrations by defining the variable RUN_MIGRATIONS=1.