# rss

> Self-hosted RSS/Atom aggregator with a Twitter-like UI, multiple layouts, dark mode, and plaintext feed config. Runs via Docker.

- **Category:** Feed Reader
- **Licence:** MIT
- **Latest version:** v2.0.0
- **Open source:** oss
- **Languages:** PHP, Vue
- **Platforms:** Docker, Docker Compose
- **Tags:** RSS, Atom, Responsive, Feed Reader, Aggregator, Docker, Php, Laravel, Dark mode, Self Hosted, Rss Aggregator, Inertia.js

## Description

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.

## Links

- [Homepage](https://github.com/ssddanbrown/rss)
- [Website](https://codeberg.org/danb/rss)
- [Docker](codeberg.org/danb/rss)
- [Source Code (GitHub mirror)](https://github.com/ssddanbrown/rss)
- [Documentation](https://codeberg.org/danb/rss)

---
Source: https://selfhost.directory/project/rss