DockerFull install guide

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

Updatedlast year

Setup difficultyEasy

MobileResponsive

ThemeDark mode

Port: 80 (HTTP application access served by Caddy inside the container; map to a host port (e.g. 8080:80).)

Docker

codeberg.org/danb/rss

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.

DanB/RSS alternatives

Should you self-host DanB/RSS?

DanB/RSS scores 53/100 on selfhost.directory (how scoring works) and ranks #19 of 86 in 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 (85/100, 46 973 stars). It scores higher overall, so compare the two before you pick. See DanB/RSS vs RSSHub side by side.

Features

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

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

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

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

---
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

git, PHP, composer and NodeJS

# 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

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