Skip to content

Miniflux

Follow your favorite blogs, news sites, and podcasts — all in one place.

  • Miniflux

    Self-hosted RSS/Atom feed reader.

    miniflux.hdhomelab.com

  • Authentication

    Sign in with your homelab account via Authentik SSO.

  • Keyboard Shortcuts

    Navigate and manage feeds without touching the mouse.

  • Categories

    Group feeds by topic to keep your reading list tidy.

Signing In

Miniflux uses Authentik SSO — no separate password needed.

  1. Go to miniflux.hdhomelab.com.
  2. Click Sign in with Authentik.
  3. Authenticate with your homelab credentials.

First login

Your Miniflux account is created automatically on first sign-in. No pre-registration required.

Adding Feeds

  1. Click Feeds in the top menu → Add Subscription.
  2. Paste a website URL or direct feed URL.
  3. Miniflux will auto-discover the feed if you paste a regular page link.
  4. Optionally assign a Category, then click Submit.

Finding RSS feeds

Most blogs and news sites publish an RSS feed. Try appending /feed, /rss, or /atom.xml to the site URL — or just paste the homepage and let Miniflux discover it.

Reading Articles

  • Unread in the top menu shows all new articles across all feeds.
  • Click an article title to read it inline.
  • Click the external link icon to open the original page.
  • Use Mark All as Read to clear an entire feed at once.

Keyboard Shortcuts

Key Action
G U Go to Unread
G B Go to Bookmarks
J / K Next / previous article
O Open selected article
V Open original link in new tab
M Toggle mark as read
S Toggle star / bookmark
F Fetch full content from original page
R Refresh current feed
Shift+A Mark all as read
? Show all shortcuts

Tip

Press ? at any time for the full shortcut reference directly in the app.

Organizing Feeds

Categories let you group feeds by topic (e.g. Tech, News, Podcasts).

  1. Go to Categories → Create Category and give it a name.
  2. When adding or editing a feed, pick the category from the dropdown.

Feeds can be moved between categories at any time via Feeds → click a feed → Edit.

Mobile Apps & API

Miniflux supports the Fever and Google Reader APIs, making it compatible with most third-party RSS apps.

Use any app that supports Fever or Google Reader API:

  • iOS: Reeder, Unread, lire
  • Android: FeedMe, Read You, Fluent Reader

Generate an API key in Settings → API Keys and use your Miniflux URL as the server address.

Full API reference: miniflux.app/docs/api.html.

Generate an API key in Settings → API Keys.