Analytics cookies only (Google Analytics, PostHog). No ad networks, no cross-site tracking. See our privacy policy.
A web-based feed aggregator that ships as a single Go binary and stores its data in SQLite by default, with PostgreSQL as an option. It has a three-pane reader with folders, an unread/starred/all filter, full-text search, OPML import and export, and feed discovery from a page URL when adding a feed; it can fetch full article content and has a Fever API for use with mobile reader apps. Optional login is set with one username:password credential, and the same binary runs as a desktop app on Windows, macOS and Linux.
Runs on a VPS from $4/mo (Kamatera 1GB, 1 GB RAM) · prices checked Nov 2026
Fits home hardware (4 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 yarr when one person wants a self-hosted feed reader that is a single small binary with no database server to run. It has a three-pane reader with folders, unread, starred and all filters, search, OPML import and export, and a "read here" action that fetches the full article, and it speaks the Fever API so Reeder, Unread and similar apps can connect. It is MIT-licensed Go, and storage is SQLite by default with PostgreSQL available through `YARR_DB`. Upstream's documentation uses `nkanaev/yarr:latest` with a `docker run` command (and a Compose file only for the PostgreSQL variant); our snippet is a Compose file for the default SQLite setup using the GitHub Container Registry image pinned to `ghcr.io/nkanaev/yarr:v2.9` (released 2026-09-07), with the data on a named volume, login enabled and HTTPS with a self-signed certificate. The docs give no RAM figure, so our 64 MB floor is an estimate. In the catalog, FreshRSS and Miniflux are multi-user readers (FreshRSS with extensions and scraping, Miniflux on PostgreSQL), CommaFeed and Fusion are single-container readers, and Tiny Tiny RSS runs as several containers; yarr is the smallest of them and has one login, so it suits a single reader.
Paid link — we earn a commission if you shop through it.
Run these commands on your server:
# yarr — web feed reader — image ghcr.io/nkanaev/yarr built from etc/dockerfile, pinned to v2.9 (upstream documents docker run for SQLite and a Compose file only for PostgreSQL; this SQLite Compose file is ours)
# Changed from upstream: a named volume for /data, login enabled through YARR_AUTH (a password generated into .env; the image default is no authentication), and HTTPS with a self-signed certificate because yarr sets its login cookie with the Secure flag, which browsers drop over plain http
mkdir yarr && cd yarr
mkdir certs
openssl req -x509 -newkey rsa:2048 -nodes -days 365 -subj "/CN=yarr" -keyout certs/key.pem -out certs/cert.pem
echo "YARR_AUTH=admin:$(openssl rand -hex 12)" > .env
cat > docker-compose.yml <<'EOF'
services:
yarr:
image: ghcr.io/nkanaev/yarr:v2.9
restart: unless-stopped
env_file: .env
environment:
YARR_CERTFILE: /certs/cert.pem
YARR_KEYFILE: /certs/key.pem
ports:
- "7070:7070"
volumes:
- yarr-data:/data
- ./certs:/certs:ro
volumes:
yarr-data:
EOF
docker compose up -d
timeout 300 bash -c 'until curl -sk -o /dev/null https://localhost:7070/; do sleep 3; done'
. ./.env
curl -sk -c cookies.txt --data-urlencode "username=admin" --data-urlencode "password=${YARR_AUTH#*:}" https://localhost:7070/login
curl -skf -b cookies.txt -o /dev/null https://localhost:7070/api/status
# → https://SERVER_IP:7070 (accept the self-signed certificate warning, then log in as admin with the password in YARR_AUTH in .env and add a feed)yarr's documentation, Dockerfile and source flag these before you rely on it:
yarr used 4 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 64 MB.
The yarr install snippet is marked verified on Ubuntu 26.04 (Nov 2026).