Skip to main content
50% off all plans, limited time. Starting at $2.48/mo
Miniflux

Miniflux

Miniflux is a minimalist and opinionated feed reader. No ads, no tracking, no bloat: just your RSS, Atom, and JSON feeds in a fast interface backed by PostgreSQL. Apache-2.0 licensed with 9,400+ GitHub stars.

At a glance

9.5k

GitHub stars

71

Active installs

License Apache-2.0 Version Latest OS Ubuntu Server 24.04 LTS Min RAM 1 GB IP IPV4

Active installs is sample data (staging preview); real metric wires in before launch.

Access Miniflux

Open in your browser: http://<IP>

Login credentials are stored in: /root/miniflux/.env

Retrieve credentials:

grep ADMIN_ /root/miniflux/.env

Credentials can be changed from the Miniflux web interface after logging in.

Important Files & Directories

  • Install Path: /root/miniflux
  • Compose File: /root/miniflux/docker-compose.yml
  • Environment File: /root/miniflux/.env
  • Caddy Config: /root/miniflux/Caddyfile
  • Database Volume: /var/lib/docker/volumes/miniflux_miniflux-db
  • Caddy Data Volume: /var/lib/docker/volumes/miniflux_caddy_data
  • Caddy Config Volume: /var/lib/docker/volumes/miniflux_caddy_config

Managing the Stack

Change into the installation directory:

cd /root/miniflux

Check container status:

docker compose ps

View logs:

docker compose logs -f

Restart the application:

docker compose restart

Stop the stack:

docker compose down

Start the stack:

docker compose up -d

Domain & HTTPS (Caddy)

0. HTTPS certificates cannot be issued for IP addresses.

1. Point a domain (for example, miniflux.example.com) to your server's IP address.

2. Edit /root/miniflux/.env and update BASE_URL:

BASE_URL=https://miniflux.example.com

3. Update /root/miniflux/Caddyfile:

miniflux.example.com {
    reverse_proxy miniflux:8080
}

4. Recreate the services:

docker compose -f /root/miniflux/docker-compose.yml up -d

5. Caddy will automatically obtain and renew SSL certificates.

More in Self Hosted

Related apps.

Deploy Miniflux now. From $2.48/mo.