# Readflow

Readflow is a lightweight, privacy-focused RSS reader and read-later app that gathers articles from your feeds and webhooks into one centralized flow. It is open source and self-hosted, installable on Docker Hub.

Canonical page: https://ourlocalhost.com/app/8705/readflow

## Description

Readflow is a lightweight, privacy-focused RSS reader and read-later app that gathers articles from your feeds and webhooks into one centralized flow. You can save articles for offline reading in the format you want (HTML, PDF, EPUB, ZIP), organize them into categories or tags, and use a built-in scripting engine to customize how articles are processed. It connects to outside services through incoming and outgoing webhooks (Pocket, RSS, Keeper, Shaarli, wallabag, S3 and more), making it a simple, ad-free reading setup for homelabbers who want ownership of their article flow.

## Platform availability

Available on 3 of 10 platforms: Mac, Linux, Any server.

## Desktop and other devices

Mac, Linux.

## Health score

51/100 (Fair), based on 4 of 5 factors.
- Maintained: 77 (last commit 3 days ago)
- Popular: 54 (476 GitHub stars)
- Easy to install: 45 (3 install platforms, install notes)
- Security check: 0 (7 serious findings, 7 minor, CI, tests, OpenSSF Scorecard 3.7/10)

## Security check

7 serious findings: Uses golang.org/x/crypto v0.45.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.45.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.45.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.45.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.45.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.45.0, which has a known critical vulnerability; Uses golang.org/x/crypto v0.45.0, which has a known critical vulnerability.
Automated checks on commit cb54d23, 21 Nov 2026. Not an audit.

## Links

- Official website: https://readflow.app
- GitHub: https://github.com/ncarlier/readflow
- desktop: https://github.com/ncarlier/readflow/releases/latest
- Docker Hub: https://hub.docker.com/r/ncarlier/readflow

## Common questions

### How do I run Readflow with Docker and which port does it use?

The Docker example maps port 8080 from the container and sets an empty READFLOW_DATABASE_URI environment variable. The web UI is then available on localhost port 8080.

### How do I configure Readflow?

Use a TOML configuration file passed with the -c parameter or via the READFLOW_CONFIG environment variable. You can generate a sample file with the init-config -f config.toml command.

### How do I authenticate to the API or use readflow-ctl?

The CTL supports Basic Auth or OIDC Device Code Flow. The default Docker Compose file mounts a passwd file with a demo user and demo password.

### Is there a mobile app for Readflow?

Mobile support is provided through the web UI as a Progressive Web App, giving the same experience as desktop.

### Which formats can I save articles in for offline reading?

Articles can be saved in HTML, PDF, EPUB, or ZIP format.

### Can Readflow connect to other services?

It uses incoming and outgoing webhooks to connect to services such as Pocket, RSS, Keeper, Shaarli, wallabag, and S3 buckets.

## Alternatives

- Calibre-go
- FreshRSS: FreshRSS is a lightweight, customizable, self-hosted Really Simple Syndication (RSS) and Atom feed aggregator for organizing and reading fe…
- Glance: Glance is a self-hosted dashboard that aggregates RSS, subreddit posts, YouTube, and server statistics.
- Liseur
- ReadAnywhere

---
Source: Our Local Host (https://ourlocalhost.com/app/8705/readflow), the self-hosted and open-source app directory.
