blumeops/argocd/manifests/miniflux/README.md

Miniflux Kubernetes Deployment

RSS/Atom feed reader deployed via ArgoCD.

Prerequisites

• CloudNativePG PostgreSQL cluster running in databases namespace
• Miniflux database and user created in PostgreSQL (from Phase 3 migration)
• Tailscale operator installed

Setup

1. Create the namespace and database secret:

kubectl create namespace miniflux
op inject -i argocd/manifests/miniflux/secret-db.yaml.tpl | kubectl apply -f -

2. Apply the ArgoCD application:

kubectl apply -f argocd/apps/miniflux.yaml
argocd app sync miniflux

Access

• URL: https://feed.tail8d86e.ts.net
• Exposed via Tailscale Ingress

Configuration

Environment variables in deployment.yaml:

• POLLING_FREQUENCY: How often to check feeds (minutes)
• BATCH_SIZE: Number of feeds to refresh per interval
• CLEANUP_ARCHIVE_UNREAD_DAYS: Days to keep unread entries
• CLEANUP_ARCHIVE_READ_DAYS: Days to keep read entries

Management

# 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

Database Connection

Connects to PostgreSQL via internal k8s DNS: blumeops-pg-rw.databases.svc.cluster.local:5432

The database is also accessible externally via Tailscale at: pg.tail8d86e.ts.net:5432