Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
Generates RSS and Atom feeds for websites and services that do not offer them, from a catalogue of community-written routes such as /test/1. It is not a reader: you point a feed reader, such as the ones elsewhere in this category, at your instance's URLs. Routes fetch the source site live, are cached in Redis and can be rate-limited or blocked by the site they scrape; routes that need a browser need the separate chromium-bundled image or a Browserless service, which this snippet leaves out.
Runs on a VPS from $6/mo (Kamatera 2GB, 2 GB RAM) · prices checked Nov 2026
Fits home hardware (251 MB measured idle, RAM only): Raspberry Pi 4 (4 GB) (arm64 untested), Raspberry Pi 5 (8 GB) (arm64 untested), Repurposed laptop (8 GB), Intel N100 mini PC (16 GB), AMD Ryzen mini PC (32 GB).
Pick RSSHub when the sites you follow have no feed and you want your own generator for them, feeding the reader you already use. It is a catalogue of community-written routes: a request to a path such as `/test/1` makes the server fetch the source site, build an RSS or Atom document and cache it. It is not a reader, so pair it with FreshRSS, Miniflux, CommaFeed, Fusion or Tiny Tiny RSS from this category. It is AGPL-3.0 TypeScript on Node. Our snippet is upstream's `docker-compose.yml` with the Browserless service and its Playwright setting removed, and the images pinned: `diygod/rsshub:2026-11-08` (a date tag the workflow overwrites on every build that day; this build was pushed to Docker Hub 2026-11-08) by its manifest digest, and `redis:8.10.3-alpine`, with a Redis health check that holds RSSHub back until it answers. The Compose file and Dockerfile give no RAM figure, so our 512 MB floor is an estimate. Compared with the readers, FreshRSS can scrape pages that dropped their feed, while RSSHub covers sites through community-written routes.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# RSSHub — RSS feed generator for sites without feeds — adapted from upstream docker-compose.yml, image pinned to the 2026-11-08 date tag by digest, Redis pinned to 8.10.3
# Changed from upstream: Browserless/Playwright service removed (the default image has no browser), images pinned, Redis healthcheck gates startup
mkdir rsshub && cd rsshub
cat > docker-compose.yml <<'EOF'
services:
rsshub:
image: diygod/rsshub:2026-11-08@sha256:4121aff746675561ecd96c3e5299dce7729bbfc508a593c07ae2d8ff91fef29c
restart: always
ports:
- '1200:1200'
environment:
NODE_ENV: production
CACHE_TYPE: redis
REDIS_URL: 'redis://redis:6379/'
healthcheck:
test: ['CMD', 'curl', '-f', 'http://localhost:1200/healthz']
interval: 30s
timeout: 10s
retries: 3
depends_on:
redis:
condition: service_healthy
redis:
image: redis:8.10.3-alpine
restart: always
volumes:
- redis-data:/data
healthcheck:
test: ['CMD', 'redis-cli', 'ping']
interval: 30s
timeout: 10s
retries: 5
start_period: 5s
volumes:
redis-data:
EOF
docker compose up -d
timeout 300 bash -c 'until curl -fsS -o /dev/null http://localhost:1200/healthz; do sleep 3; done'
curl -fsS http://localhost:1200/test/1 | head -c 600
# → http://SERVER_IP:1200 (no login; /test/1 is the built-in test route, other routes are listed in the RSSHub docs and fetch the source site live)RSSHub's Compose file, Dockerfile and source flag these before you rely on it:
RSSHub used 251 MB of RAM at idle on GCP e2-standard-2 · Ubuntu 26.04 LTS · Docker 29.9.3 (first boot, measured Nov 2026). We list a minimum of 512 MB.
The RSSHub install snippet is marked verified on Ubuntu 26.04 (Nov 2026).