selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

Newspipe logo

Self-host Newspipe

v12.3.0

Self-hosted web news aggregator for RSS/Atom feeds

ReleaseOpen SourceAGPL-3.0
Updated8 hours ago
LanguagePython
Setup difficultyAdvanced
MobileResponsive
ThemeDark mode
Stars
498
Port
5000 (Web server)
Requires
Python
Install with Build from Source
Newspipe home page showing feed list and article view

What is Newspipe?

Newspipe is a self-hosted web news aggregator built with Flask, asyncio, and SQLAlchemy. It lets individuals or teams own their feed data with multi-user support, a REST API for programmatic feed management, and full data portability via JSON and OPML import/export. Features include search and favorites, inactive feed detection, bookmark management with Pinboard import, article notes, internationalization (English, French, German), optional LDAP authentication, and built-in light/dark themes. It runs on Python 3.13+ with SQLite (default) or PostgreSQL, and feeds are fetched via a scheduled cron job. The project is licensed under AGPL-3.0 and accepts donations via GitHub Sponsors and Bitcoin.

Should you self-host Newspipe?

Newspipe scores 49/100 on selfhost.directory (how scoring works) and ranks #32 of 85 in Feed Reader. It has 498 GitHub stars.

It shipped 9 stable releases in the past year. The latest, v12.3.0, came out on 22 October 2026. New versions land roughly every 2 weeks.

Setup is advanced: plan for several services and some ongoing maintenance. It is AGPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is RSSHub (85/100, 46 704 stars). It scores higher overall, so compare the two before you pick. See Newspipe vs RSSHub side by side.

Features

  • Article notes
  • Bookmark Management
  • Data import/export (JSON)
  • Inactive feed detection
  • Internationalization
  • LDAP Authentication
  • Multi-user support
  • OPML Import/Export
  • REST API
  • Scheduled feed fetching
  • Search and favorites
  • Two-factor authentication (TOTP)

Newspipe README

How to install Newspipe

Install Newspipe with Build from Source

Environment variables
NEWSPIPE_CONFIG=sqlite.py or postgresql.py
git clone https://github.com/cedricbonhomme/newspipe
cd newspipe/
npm ci
poetry install
poetry shell
pybabel compile -d newspipe/translations
export NEWSPIPE_CONFIG=sqlite.py
flask db_init
flask db stamp head
flask create_admin --nickname <nickname> --password <password>
flask run --debug

Requires git, poetry, npm, and Python >= 3.13

How to configure Newspipe

  • CRAWLER_MAX_CONCURRENCY10Maximum concurrent feed fetches

    Maximum concurrent feed fetches

  • CRAWLER_MAX_FEED_SIZE10485760Maximum feed body size in bytes

    Maximum feed body size in bytes

  • DEBUGTrueEnable debug mode

    Enable debug mode

  • FEED_REFRESH_INTERVAL120Feed refresh interval in minutes

    Feed refresh interval in minutes

  • HOST0.0.0.0Web server host address

    Web server host address

  • LDAP_ENABLEDFalseEnable LDAP authentication

    Enable LDAP authentication

  • LDAP_URIldaps://ipa.internal.com:636LDAP server URI

    LDAP server URI

  • LOG_LEVELinfoLogging level

    Logging level

  • LOG_PATH./var/newspipe.logLog file path

    Log file path

  • MAIL_PORT25SMTP port

    SMTP port

  • MAIL_SERVERlocalhostSMTP server for notifications

    SMTP server for notifications

  • NEWSPIPE_CONFIGsqlite.pyConfiguration file to use (set as environment variable)

    Configuration file to use (set as environment variable)

    values: sqlite.py, postgresql.py

  • OPML_MAX_SIZE5242880Maximum OPML upload size in bytes

    Maximum OPML upload size in bytes

  • PORT5000Web server port

    Web server port

  • SECRET_KEYLCx3BchmHRxFzkEv4BqQJyeXRLXenfSecret key for CSRF and sessions

    Secret key for CSRF and sessions

  • SELF_REGISTRATIONTrueAllow user self-registration

    Allow user self-registration

  • SQLALCHEMY_DATABASE_URIsqlite:///instance/newspipe.dbDatabase connection URI

    Database connection URI

  • TOTP_ISSUERwww.newspipe.orgIssuer name for TOTP two-factor authentication

    Issuer name for TOTP two-factor authentication

Newspipe releases & version history

More in Feed Reader

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…