miniflux — Launchfile Catalog

Launchable on Launchfile— managed hosting from $5/mo.

Run locally

Tested and verified to launch successfully.

Terminal

$ npx launchfile up miniflux

Requires Docker Desktop. No source code needed — pulls pre-built images and starts miniflux with all dependencies.

Terminal

# Clone the source and run natively
$ git clone https://github.com/miniflux/v2
$ cd miniflux
$ npx launchfile up --native

For local development. Requires macOS + Homebrew. Clones the source, installs runtimes and databases via Homebrew, and runs the app natively — no containers.

Image:miniflux/miniflux:latest

LaunchfileView on GitHub

# yaml-language-server: $schema=https://launchfile.dev/schema/v1
version: launch/v1
name: miniflux
description: "Minimalist and opinionated feed reader"
repository: https://github.com/miniflux/v2
logo: https://raw.githubusercontent.com/miniflux/v2/main/internal/ui/static/bin/icon-512.png

image: miniflux/miniflux:latest
provides:
  - name: web
    protocol: http
    port: 8080
    exposed: true
    tls: server-cert
requires:
  - type: postgres
    set_env:
      DATABASE_URL: $url
supports:
  # Miniflux switches the SAME listen address to TLS when both files are
  # supplied: internal/http/server/server.go:115 computes hasCertFiles and
  # :135-141 selects the TLS server. CERT_FILE, KEY_FILE and PORT are
  # configuration options (internal/config/options.go:121, :312, :519).
  - name: server-cert
    type: certificate
    set_env:
      PORT: "8080"
      CERT_FILE: $cert_file
      KEY_FILE: $key_file
env:
  RUN_MIGRATIONS:
    default: "1"
    description: "Run database migrations on startup"
  CREATE_ADMIN:
    default: "1"
    description: "Create admin user on first run"
  ADMIN_USERNAME:
    default: "admin"
    description: "Admin username"
  ADMIN_PASSWORD:
    required: true
    sensitive: true
    description: "Admin password"
    generator: secret
  BASE_URL:
    default: $app.url
    description: "Public-facing URL; miniflux uses it for absolute links and feed URLs"
health: /healthcheck
restart: always