blumeops/docs/zk/miniflux.md
Erich Blume 7112297150 Move zk cards to docs/zk/ for documentation restructuring
Phase 1 of docs restructuring: move all zettelkasten cards to a
temporary docs/zk/ subdirectory while preparing to build a new
Diataxis-based documentation structure.

- Move all existing markdown files from docs/ to docs/zk/
- Update zk-docs mise task to look in the new location
- Add docs/README.md explaining the restructuring plan

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2026-02-03 07:57:47 -08:00

2.2 KiB

id aliases tags
miniflux
miniflux
feed
rss
blumeops

Miniflux Management Log

Miniflux is a minimalist RSS/Atom feed reader running in Kubernetes (minikube on indri).

Service Details

Useful Commands

# View logs
kubectl -n miniflux logs -f deployment/miniflux

# Restart deployment
kubectl -n miniflux rollout restart deployment/miniflux

# Check health
curl https://feed.tail8d86e.ts.net/healthcheck

# Sync from ArgoCD
argocd app sync miniflux

ArgoCD Management

Miniflux is deployed via ArgoCD from argocd/manifests/miniflux/:

  • deployment.yaml - Deployment with environment configuration
  • service.yaml - ClusterIP service
  • ingress-tailscale.yaml - Tailscale Ingress for external access

Credentials

The miniflux database user password is auto-generated by CloudNativePG and stored in the blumeops-pg-app secret in the databases namespace.

To recreate the miniflux-db secret:

kubectl create secret generic miniflux-db -n miniflux \
  --from-literal=url="$(kubectl -n databases get secret blumeops-pg-app -o jsonpath='{.data.uri}' | base64 -d)"

Features

  • Keyboard shortcuts for efficient reading
  • Fever and Google Reader API compatible
  • Mobile-friendly web interface
  • OPML import/export
  • Content scraping for full articles

Backup

Feed subscriptions and read state stored in postgresql, backed up via borgmatic's postgresql_databases hook.

Log

Sun Jan 19 2026

  • Migrated to Kubernetes (Phase 4 of k8s migration)
  • Deployed via ArgoCD in miniflux namespace
  • Database connection via internal k8s DNS to CloudNativePG cluster
  • Exposed via Tailscale Ingress at feed.tail8d86e.ts.net
  • Removed brew miniflux service and ansible role from indri
  • Fixed table ownership issue after P3 restore (tables were owned by eblume, needed to be owned by miniflux)

Thu Jan 16 2026

  • Initial setup with Miniflux 2.x on brew
  • Connected to PostgreSQL 18 on localhost
  • Exposed via Tailscale at feed.tail8d86e.ts.net