Self-host rss
v2.0.0Opinionated RSS feed aggregator with a social-feed UI
- Stars
- 566
- Port
- 80 (HTTP web interface)
codeberg.org/danb/rssWhat is rss?
RSS is a simple, opinionated web application that aggregates RSS and Atom feeds into a social-feed-style interface. Built with PHP and modern frontend tools, it fetches feeds on a configurable schedule (default hourly, down to 5 minutes) and presents posts in four layout modes: card, grid, list, and compact. Feeds are managed through a single plaintext file where each line defines a feed URL, custom name, color, and tags. The UI supports system-based dark/light themes, post title and description search, and hiding specific feeds by default. Old posts can be automatically pruned after a configurable number of days. The project is intentionally low-maintenance with no user system, authentication, plugin system, or full article import. It runs as a single Docker container exposing port 80, with all data stored in a mounted volume. A reverse proxy is recommended for HTTPS and sub-path hosting.
Should you self-host rss?
rss scores 50/100 on selfhost.directory (how scoring works) and ranks #27 of 85 in Feed Reader. It has 566 GitHub stars.
There was no stable release in the past 12 months, so check the repository's recent activity before you rely on it.
Setup is easy: most people get it running in one sitting. An official Docker image is available. It is MIT-licensed and written mostly in PHP.
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 rss vs RSSHub side by side.
Features
- Automatic Feed Fetching
- Custom feed names and colors
- Feed-based tags
- Hidden feeds
- Multiple layout modes
- Open Graph image fetching
- Plaintext feed configuration
- Post pruning
- Post search
- RSS and Atom feed support
rss README
More in Feed Reader
RSS2FullRSS2Full is a self-hosted, open-source service that transforms summary-only RSS feeds into full-text feeds for any RSS reader. Runs as a simple HTTP server with REST API.
RSSBoxRSS Box is a self-hosted, open-source feed generator creating RSS feeds from YouTube, Vimeo, Twitch, SoundCloud, and more via APIs. Run via Docker or Kubernetes.
RSSBoxRSSBox is a self-hosted, open-source RSS feed translator using AI engines like OpenAI and DeepL to translate, filter, and generate daily digests from foreign feeds.
RSSbrewRSSBrew is a self-hosted, open-source RSS tool that aggregates feeds, applies filters, generates AI summaries, and creates daily/weekly digests via Docker Compose.
rss-emailSelf-hosted RSS-to-email gateway: subscribe by emailing feed URLs, get updates in your inbox. Go binary or Docker, supports Outlook/Gmail.
RSSerpentRSSerpent is a self-hosted, open-source Python app that creates RSS feeds for websites lacking native RSS, inspired by RSSHub. Runs via Docker or pip on port 8000.
rss-fulltextrss-fulltext is an open-source tool that rewrites RSS feeds to include full article content. It fetches linked pages and serves enriched feeds as RSS, Atom, and JSON.
rss-funnelRSS Funnel is a self-hosted, open-source RSS multi-tool that fetches, filters, transforms, and merges feeds through a configurable YAML pipeline with a web UI.
RSS GuardSelf-hosted open-source Qt desktop feed reader for RSS, Atom and JSON feeds that syncs with FreshRSS, Miniflux, Tiny Tiny RSS and Nextcloud News, and plays podcasts.
RSSHubRSSHub is a self-hosted, open-source RSS feed generator for 5,000+ sites. Run via Docker or deploy to cloud platforms.
RSSHub PythonSelf-hosted Python RSS generator creating feeds from web pages, documents, datasets, and APIs via Flask and Playwright. Supports JS rendering, PDF/EPUB, Hugging Face.
RSS-LanceRSS-Lance is a self-hosted, open-source RSS reader storing data as plain Lance files — no database or web server needed. Runs as a Go server with Python fetcher.




0 comments