Miniflux — Minimalist Self-Hosted Feed Reader

What it is

Miniflux is an opinionated, minimalist RSS and Atom feed reader written in Go. It strips away the complexity of full-featured feed readers and focuses on three things: fast feed fetching, clean content rendering, and keyboard-driven navigation.

Miniflux runs as a single Go binary with PostgreSQL as its database. It targets developers and power users who want a self-hosted feed reader without the overhead of PHP, Redis, or complex deployment stacks.

How it saves time or tokens

Miniflux's minimalism means less time configuring and more time reading. There are no themes, no social features, no recommendation algorithms. You add feeds, Miniflux fetches and displays them. The entire UI is a clean list of articles with keyboard shortcuts for navigation.

The read-it-later integration (Pocket, Wallabag, Pinboard) and API support make Miniflux a solid backbone for custom RSS workflows.

How to use

1. Deploy with Docker:

docker run -d --name miniflux-db \
  -e POSTGRES_USER=miniflux -e POSTGRES_PASSWORD=secret \
  -e POSTGRES_DB=miniflux postgres:15

docker run -d --name miniflux \
  -p 8080:8080 \
  -e DATABASE_URL='postgres://miniflux:secret@miniflux-db/miniflux?sslmode=disable' \
  -e RUN_MIGRATIONS=1 \
  -e CREATE_ADMIN=1 \
  -e ADMIN_USERNAME=admin \
  -e ADMIN_PASSWORD=changeme \
  miniflux/miniflux:latest

1. Open http://localhost:8080 and add your RSS feeds.

1. Use keyboard shortcuts: j/k to navigate, v to open, s to star.

Example

# Miniflux API usage for custom integrations
# List all feeds
curl -u admin:changeme http://localhost:8080/v1/feeds

# Get unread entries
curl -u admin:changeme http://localhost:8080/v1/entries?status=unread

# Mark entry as read
curl -u admin:changeme -X PUT \
  http://localhost:8080/v1/entries \
  -d '{"entry_ids": [123], "status": "read"}'

Related on TokRepo

• Self-Hosted Tools -- More self-hosted applications for developers
• AI Tools for Research -- Information gathering and research tools

Common pitfalls

• Miniflux requires PostgreSQL. SQLite is not supported. You need a running Postgres instance before deploying Miniflux.
• The default polling interval is 60 minutes. Adjust POLLING_FREQUENCY if you need more frequent feed checks, but respect the feed source's rate limits.
• Miniflux has intentionally few features. If you need folder organization, tag-based filtering, or social sharing, consider a more full-featured reader.