| title | Turn Any Website Into an RSS Feed |
|---|---|
| description | Run html2rss-web with Docker, verify one feed, then enable automatic generation or move to custom configs when you need more control. |
Run html2rss-web with Docker, verify one feed from your own instance, then decide whether you need automatic generation or custom configs.
Recommended path: Run html2rss-web with Docker
That guide is the canonical onboarding flow for:
- starting a local instance
- verifying the web interface
- opening a known feed URL
- choosing the next path
html2rss is a toolkit for turning websites into feeds.
Most people should start with the web application:
html2rss-web: the self-hosted web interface and feed serverhtml2rssgem: the Ruby engine, CLI, and lower-level config workflow
- Run html2rss-web with Docker: recommended starting path
- Use the included configs: optional guide for the embedded feed set
- Creating Custom Feeds: write and test your own configs
- Selectors Reference: learn the matching rules
- Strategy Reference: choose the right extraction strategy for static vs JavaScript-heavy pages
- Ruby Gem Reference: full API documentation
- Advanced Features: custom HTTP requests and advanced extraction
- Contribute to Core: help improve the engine
- follow blogs and news sites without social media algorithms
- track product updates and release notes
- monitor job postings from company websites
- subscribe to forums and communities that do not publish feeds
- follow local news without repeated manual checking
- Start with Docker, not a public instance.
- Verify the deployment with one known feed first.
- Enable automatic generation only when you want the direct page-URL workflow and are ready to allow it on your self-hosted instance.
- Move to custom configs when you need a stable, reviewable setup.
Need help? Continue to the troubleshooting guide or join GitHub Discussions.