How do I deploy RSSBox on Railway?

You can deploy RSSBox on Railway by clicking the "Deploy Now" button on this page. Railway will automatically set up all the necessary services and configurations for you.

What are the system requirements?

Railway handles all the infrastructure requirements. You only need a web browser to deploy and manage your application.

Is this template free to use?

Yes, this template is free to use within your existing Railway account.

Can I customize this template?

Yes, you can fully customize this template. After deployment, you will have full control of what you've deployed in your Railway project.

How do I get support for this template?

You can get support through our community forum: rss-box-b0ab6bff, or click "Get template help" for this template for more assistance.

Deploy and Host RSSBox on Railway

RSSBox is an open-source, self-hosted RSS translation tool. It automatically translates RSS feeds into your preferred language using DeepL or OpenAI-compatible models, with support for bilingual display, keyword filtering, AI content curation, and full-text extraction.

About Hosting RSSBox

RSSBox runs as a Django application with Redis for caching and task queues. Data is stored in SQLite on a persistent volume. After deployment, configure a translation engine (DeepL, OpenAI-compatible APIs) via the admin panel, add your RSS sources, and RSSBox generates translated feed URLs you can subscribe to in any reader like Inoreader or Feedly.

Post-Deployment Setup

After deployment, update two environment variables to match your actual domain:

If using a custom domain (e.g., rss.your-site.com):

SITE_URL → https://rss.your-site.com
CSRF_TRUSTED_ORIGINS → https://rss.your-site.com,https://*.railway.app

If using the default Railway domain (e.g., your-app.up.railway.app):

SITE_URL → https://your-app.up.railway.app
CSRF_TRUSTED_ORIGINS → https://*.railway.app

Without these changes, SITE_URL will generate incorrect feed URLs, and CSRF_TRUSTED_ORIGINS will cause 403 errors on login.

Default credentials: admin / rssbox — change your password immediately after first login.

Common Use Cases

Translate foreign-language RSS feeds into your native language for daily reading
Generate bilingual RSS feeds for language learning
Aggregate and filter multiple RSS sources with AI-powered content curation

Dependencies for RSSBox Hosting

Redis (caching and background task queues)
Persistent volume at /app/data (SQLite database and logs)

Deployment Dependencies

Why Deploy RSSBox on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying RSSBox on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

在 Railway 上部署 RSSBox

RSSBox 是一个开源、可自部署的 RSS 翻译工具。支持通过 DeepL 或 OpenAI 兼容模型自动翻译 RSS 源，提供双语显示、关键词过滤、AI 内容筛选和全文提取等功能。

关于部署 RSSBox

RSSBox 基于 Django 运行，使用 Redis 做缓存和任务队列，数据存储在持久化卷上的 SQLite 数据库中。部署完成后，通过管理后台配置翻译引擎（DeepL、OpenAI 兼容 API），添加 RSS 源，RSSBox 会生成翻译后的订阅地址，可在 Inoreader、Feedly 等阅读器中直接订阅。

部署后必须操作

部署完成后，需要更新两个环境变量为你的实际域名：

使用自定义域名（如 rss.your-site.com）：

SITE_URL → https://rss.your-site.com
CSRF_TRUSTED_ORIGINS → https://rss.your-site.com,https://*.railway.app

使用 Railway 默认域名（如 your-app.up.railway.app）：

SITE_URL → https://your-app.up.railway.app
CSRF_TRUSTED_ORIGINS → https://*.railway.app

不修改 SITE_URL 会导致生成的订阅地址错误，不修改 CSRF_TRUSTED_ORIGINS 会导致登录时报 403 错误。

默认账号：admin / rssbox，首次登录后请立即修改密码。

常见用途

将外语 RSS 源自动翻译为母语，方便日常阅读
生成双语 RSS 订阅，辅助语言学习
聚合多个 RSS 源，通过 AI 智能筛选和生成日报

部署依赖

Redis（缓存和后台任务队列）
持久化卷挂载到 /app/data（存储 SQLite 数据库和日志）

为什么选择 Railway 部署？

Railway 提供一站式基础设施部署平台，无需手动配置服务器，支持垂直和水平扩展。在 Railway 上部署 RSSBox，可以轻松搭建完整的应用栈，同时托管服务、数据库等组件。