# DanB/RSS

> Open-source, self-hosted RSS and Atom aggregator that shows entries in a Twitter-style feed with four layout modes, tags, search, dark theme and hourly auto-fetching.

- **Category:** [Feed Reader](https://selfhost.directory/feed-reader)
- **Licence:** MIT
- **Source model:** Open source
- **Latest version:** null
- **Author:** Dan Brown
- **Platforms:** Docker, Docker Compose, Build from Source
- **Ports:** 80 (HTTP application access served by Caddy inside the container; map to a host port (e.g. 8080:80).)
- **Tags:** SQLite, RSS, Atom, Feed Reader, Feed Aggregator, Docker, Php, Laravel, Vue, Tailwind

## Docker images

- [`codeberg.org/danb/rss`](https://codeberg.org/danb/rss) — Main application image (Caddy + PHP), built from docker/Dockerfile

## What is DanB/RSS?

DanB/RSS is a small, opinionated web app that pulls RSS and Atom feeds together and presents them in a clean social-media-style timeline, built on Laravel, Inertia.js, Vue and Tailwind. Feeds refresh automatically (hourly by default, down to five minutes), posts can be searched by title or description, and each feed gets a custom name and CSS color plus tags for grouping. Four layouts (card, grid, list, compact) are provided, open-graph thumbnails are fetched for posts, a system-based dark/light theme is used, and old entries can be pruned automatically after a set number of days. The whole app runs from one Docker image that keeps all state in a single /app/storage directory, where a plaintext feeds.txt file lists the subscriptions; environment variables cover the app name, fetch interval, thumbnail loading and pruning. There is no web UI for managing feeds, no authentication or user accounts, no full-article import and no plugin system, so HTTPS and access control are expected to come from a reverse proxy such as nginx. The author describes it as a low-maintenance project with a deliberately narrow scope.

## Should you self-host DanB/RSS?

DanB/RSS scores **53/100** on selfhost.directory ([how scoring works](https://selfhost.directory/scoring)) and ranks **#19 of 86** in [Feed Reader](https://selfhost.directory/feed-reader).

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.

Its closest alternative on selfhost.directory is [RSSHub](https://selfhost.directory/project/rsshub) (85/100, 46 973 stars). It scores higher overall, so compare the two before you pick. [See DanB/RSS vs RSSHub side by side.](https://selfhost.directory/compare/danbrss-vs-rsshub)

## Features

- Automatic Feed Fetching
- Built-in Authentication (✗ not supported) — Put it behind a reverse proxy if access control is needed.
- Custom feed names and colors
- Feed management UI (✗ not supported) — Feeds are only editable in the plaintext config file.
- Feed tags
- Full article content import (✗ not supported)
- Hidden feeds
- Multiple layout modes
- Plain-text feed configuration
- Post pruning
- Post thumbnails
- RSS/Atom Support
- Search
- User Accounts (✗ not supported)

## How to install DanB/RSS

### Install DanB/RSS with Docker

Environment variables:

```
APP_NAME,APP_CONFIG_FILE,APP_LOAD_POST_THUMBNAILS,APP_FEED_UPDATE_FREQUENCY,APP_PRUNE_POSTS_AFTER_DAYS,SERVER_PORT
```

```shell
docker run -d \
    --restart unless-stopped \
    -p 8080:80 \
    -v /home/barry/rss:/app/storage \
    codeberg.org/danb/rss:latest
```

Note: State lives in the mounted /app/storage directory; feeds.txt goes there. HTTPS must be terminated by a proxy layer.

### Install DanB/RSS with Docker Compose

Environment variables:

```
APP_NAME
```

```yml
---
version: "2"
services:
    rss:
        image: codeberg.org/danb/rss:latest
        container_name: rss
        environment:
            - APP_NAME=RSS
        volumes:
            - ./rss-files:/app/storage
        ports:
            - "8080:80"
        restart: unless-stopped
```

### Install DanB/RSS with Build from Source

Requirements: git, PHP, composer and NodeJS

```shell
# Clone down and enter the project
git clone https://codeberg.org/danb/rss.git
cd rss

# Install PHP dependencies via composer
composer install

# Create database file
touch storage/database/database.sqlite

# Copy config, generate app key, migrate database & link storage
cp .env.example .env
php artisan key:generate
php artisan migrate
php artisan storage:link

# Install JS dependencies & build CSS/JS
npm install
npm run build
```

Note: Not recommended unless doing development work; the docker image is advised. Needs a webserver for public, plus queue worker and cron for the schedule.

## DanB/RSS alternatives

- [FreshRSS](https://selfhost.directory/project/freshrss): Open-source, self-hosted feed reader: multi-user RSS/Atom aggregation with WebSub push, XPath scraping of pages without feeds, OPML import/export and mobile app APIs. (compare: https://selfhost.directory/compare/danbrss-vs-freshrss)
- [Tiny Tiny RSS](https://selfhost.directory/project/tiny-tiny-rss): Self-hosted, open-source web RSS/Atom reader and aggregator with folders, OPML, filters, plugins, themes and a JSON API; runs via Docker Compose with PostgreSQL. (compare: https://selfhost.directory/compare/danbrss-vs-tiny-tiny-rss)
- [RSS-Proxy](https://selfhost.directory/project/rss-proxy): Open-source, self-hosted feed generator that converts any static website into RSS, ATOM or JSON feeds, filters existing feeds, and runs from a single Docker container. (compare: https://selfhost.directory/compare/danbrss-vs-rss-proxy)
- [selfoss](https://selfhost.directory/project/selfoss): Open-source, self-hosted PHP web app that pulls feeds, tweets and posts into one stream, with OPML import, regex filters, a spout plugin system and a REST JSON API. (compare: https://selfhost.directory/compare/danbrss-vs-selfoss)
- [rss-reader](https://selfhost.directory/project/rss-reader): A lightweight, self-hosted RSS feed reader in Go that aggregates multiple feeds with real-time WebSocket updates, auto-refresh, dark mode, and responsive design. (compare: https://selfhost.directory/compare/danbrss-vs-rss-reader)
- [RSSHub](https://selfhost.directory/project/rsshub): RSSHub is a self-hosted, open-source RSS feed generator for 5,000+ sites. Run via Docker or deploy to cloud platforms. (compare: https://selfhost.directory/compare/danbrss-vs-rsshub)
- [Feedpushr](https://selfhost.directory/project/feedpushr): Self-hosted feed aggregator daemon with WebSub, OPML import/export, pluggable outputs/filters, web UI and CLI. Pushes articles to HTTP, email, Readflow. (compare: https://selfhost.directory/compare/danbrss-vs-feedpushr)
- [RSS-Bridge](https://selfhost.directory/project/rss-bridge): Self-hosted, open-source PHP app that generates RSS, Atom and JSON feeds for websites missing them, with 447 community bridges and file, SQLite or Memcached caching. (compare: https://selfhost.directory/compare/danbrss-vs-rss-bridge)

## More in Feed Reader

- [discord-rss-bot](https://selfhost.directory/project/discord-rss-bot): Self-hosted Discord bot that monitors RSS feeds and posts updates to channels in real-time with configurable intervals and Docker support.
- [Django-link-archive](https://selfhost.directory/project/django-link-archive): Self-hosted, open-source link database and RSS reader aggregating bookmarks, YouTube, Reddit, and email into a searchable archive with dark mode.
- [eddrit](https://selfhost.directory/project/eddrit): Self-hosted, open-source alternative frontend for Reddit with no ads, mobile-friendly design, and RSS support. Runs on Python/Starlette with Valkey for token storage.
- [El Monitorro](https://selfhost.directory/project/el-monitorro): A self-hosted feed reader delivering RSS, Atom, and JSON updates through a Telegram bot with templates, filters, and timezone handling.
- [f43.me](https://selfhost.directory/project/f43me): f43.me is a self-hosted, open-source RSS feed proxy that fetches feed items, extracts full article content using readability parsers, and serves clean, readable feeds.
- [Feedbin](https://selfhost.directory/project/feedbin): Feedbin is an RSS feed reader alternative to Google Reader with dark mode, full-text extraction and podcasts. Self-hosting possible but complex.
- [FeedCord](https://selfhost.directory/project/feedcord): FeedCord is a self-hosted, open-source RSS/YouTube feed reader that posts updates to Discord via webhooks, supporting forum channels and post filtering.
- [FeedCraft](https://selfhost.directory/project/feedcraft): FeedCraft is a self-hosted, open-source RSS processor that extracts full text, translates articles, generates AI summaries, and filters feeds. Runs via Docker.
- [FeedDeck](https://selfhost.directory/project/feeddeck): Open-source feed reader combining RSS, YouTube, Reddit, GitHub, podcasts and more in a TweetDeck-style deck layout. Self-hostable via Supabase and Docker.
- [FeedHQ](https://selfhost.directory/project/feedhq): FeedHQ is a self-hosted, open-source web feed reader with RSS/ATOM support, categories, mobile-first design, and Pocket/Instapaper/Readability integration.
- [feedlynx](https://selfhost.directory/project/feedlynx): Feedlynx is a self-hosted, open-source read-later service generating an Atom feed for RSS readers. Runs as a lightweight Rust binary with Docker support.
- [FeedMe](https://selfhost.directory/project/feedme): Self-hosted RSS reader that aggregates feeds from multiple sources and uses LLMs to generate article summaries, deployable via Docker, GitHub Pages, or Vercel.

## Links

- [Homepage](https://codeberg.org/danb/rss)
- [DanB/RSS repository](https://codeberg.org/danb/rss)

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