selfhost.directory

The index of self-hostable projects — ranked, categorized and served with live updates.
Own your data and stop giving it to big tech.

RSSBox logo

Self-host RSSBox

2026.10.20

AI-powered RSS translator and feed aggregator

ReleaseOpen SourceGPL-3.0
Updatedlast week
LanguagePython
Setup difficultyModerate
Stars
682
Port
8000 (HTTP web interface)
Requires
Redis
Docker
versun/rssbox
Install with Docker Compose

What is RSSBox?

RSSBox is a self-hosted RSS feed management tool that translates foreign-language content using AI translation engines including OpenAI-compatible models, DeepL, and LibreTranslate. It supports per-feed translation engine selection, keyword and AI-based content filtering, tag-based feed aggregation, and AI-generated daily digests. The application is built with Django and deployed via Docker Compose with Redis for caching. It provides both RSS and JSON output formats for translated feeds. The project is licensed under GPL-3.0 and offers a demo instance at rssbox.app/demo.

Should you self-host RSSBox?

RSSBox scores 52/100 on selfhost.directory (how scoring works) and ranks #21 of 85 in Feed Reader. It has 682 GitHub stars.

It shipped 9 stable releases in the past year. The latest, 2026.10.20, came out on 20 October 2026. New versions land roughly every 3 weeks.

Setup is moderate: expect some configuration beyond a single command. An official Docker image is available. It is GPL-3.0-licensed and written mostly in Python.

Its closest alternative on selfhost.directory is RSSHub (85/100, 46 702 stars). It scores higher overall, so compare the two before you pick. See RSSBox vs RSSHub side by side.

Features

  • AI Daily Digest Generation
  • AI Smart Filtering
  • AI Translation
  • Batch Operations
  • Bilingual Display
  • Data privacy
  • Feed Aggregation by Tags
  • Full-Text Extraction
  • Keyword Filtering
  • Multi-Engine Translation
  • Real-time monitoring
  • RSS/JSON output
  • Token/Character Usage Tracking
  • Update Frequency Control

RSSBox README

How to install RSSBox

Install RSSBox with Docker Compose

Environment variables
SITE_URL, SECRET_KEY, DEBUG, REDIS_URL, CSRF_TRUSTED_ORIGINS, TIME_ZONE, DEFAULT_TARGET_LANGUAGE, OPENAI_API_TIMEOUT, OPENAI_API_MAX_RETRIES, LOG_LEVEL, PORT, DEMO, USER_MANAGEMENT

进入要存放数据的文件夹,如/home/versun/rssbox/ 下载docker-compose.yml文件 wget "https://raw.githubusercontent.com/versun/rssbox/main/deploy/docker-compose.yml" 运行 docker-compose -f docker-compose.yml up -d 安装完成,访问 http://127.0.0.1:8000 默认账户:admin 密码:rssbox 请登录后立即修改你的密码

Recommended installation method

RSSBox releases & version history

FAQ

依旧无法解决?

Submit an issue on GitHub or ask in the Telegram group.

Cloudflare的SSL设置

If Cloudflare DNS proxy is enabled, set SSL/TLS encryption mode to Full in Cloudflare dashboard.

可以设置代理服务器吗

RSSBox doesn't have built-in proxy support, but you can set HTTP_PROXY and HTTPS_PROXY environment variables.

IPv6

IPv4 and IPv6 cannot be supported simultaneously. To listen on IPv6, modify deploy/start.sh changing 0.0.0.0 to :: and restart.

我的阅读器无法订阅翻译后的地址

Check translation status is complete, verify the URL works in browser, and ensure RSSBox is accessible from your reader (check network/firewall).

标签系统问题

Check if RSS sources are correctly linked to tags, confirm linked sources have new content, and verify tag filter configuration.

AI日报生成失败

Ensure RSS sources are correctly created and linked to tags, confirm the AI engine for digest generation works, and verify tags have enough active sources (3-5 recommended).

AI过滤器不生效

Verify AI engine is correctly configured and valid, and check that filter prompts are clear and specific.

为什么有些内容没有翻译

Check max entries limit which restricts translation count. Free engines like Google Translate and DeepLX have rate limits causing failures; paid engines are recommended.

翻译状态 错误

Verify the translation engine is valid and the server can reach the translation service.

获取源状态 失败

Check if the feed URL is correct and accessible, verify server network connectivity, and check proxy settings for local deployments.

Server 500报错

Wait 5 minutes and try again. If on Railway, wait longer. Otherwise restart the instance or service.

报错:CSRF验证失败

Set the CSRF_TRUSTED_ORIGINS environment variable to your domain or IP address with port.

如何备份数据

All metadata is stored in data/db.sqlite3 database file, which can be backed up directly.

More in Translation

Rate this project

Click to rate — no account needed.

0 comments

Posting as guest
Loading comments…