What Do I Need to Install and Run Tiny Tiny RSS?
To install and run Tiny Tiny RSS (tt-rss), you need two things: a modern web browser (a recent version of Chrome/Chromium or Firefox) and a system running Docker. The official Installation Guide covers the detailed steps. If you choose to run tt-rss without Docker, support may be limited. Because tt-rss follows a continuous development model based on the main branch (which is considered stable), it's strongly recommended that you stay current — using either the most recent Docker image(s) or the latest commit on main.
Prerequisites at a Glance
| Requirement | Detail |
|---|---|
| Web browser | A recent version of Chrome/Chromium or Firefox |
| Container runtime | A system running Docker |
| Installation instructions | See the official Installation Guide |
| Non-Docker setups | Possible, but support may be limited |
| Version currency | Use the most recent Docker image(s) or commit on main |
Why Docker Is the Recommended Path
tt-rss is a self-hosted, web-based RSS/Atom reader and aggregator, so it runs as a service you access through a browser rather than as a desktop application. The project's installation guidance assumes Docker as the standard deployment method. Running it outside Docker is not forbidden, but the documentation notes that support may be limited in that case — meaning you take on more of the troubleshooting yourself.
Staying Current
tt-rss uses a continuous development model based on the main branch, which the project treats as stable. There are no traditional versioned releases to wait for. In practice, this means:
- Pull the most recent Docker image(s), or
- Track the latest commit on main
Staying current is strongly recommended rather than optional, since fixes and changes land on main continuously.
Where to Get Help
- Questions or discussion: https://github.com/tt-rss/tt-rss/discussions
- Bug reports and feature requests: https://github.com/tt-rss/tt-rss/issues
- Contributing (code, translations, issue reports): https://github.com/tt-rss/tt-rss/blob/main/CONTRIBUTING.md
What You Get Once It's Running
For context on what the setup delivers, tt-rss is free software licensed under GNU GPLv3 and is self-hosted, so you control your own data instead of relying on third-party services. Documented features include organizing feeds by folders and subfolders, feed aggregation and syndication, keyboard shortcuts, OPML import/export, multiple sharing methods (exported RSS feeds, plugins for social sites, sharing by URL, and sharing arbitrary content through tt-rss), plugins and themes, full article embedding via readability and site-specific plugins, deduplication (including perceptual hashing for images), podcasts, flexible article filtering, and a JSON API.
The tt-rss software is licensed under GNU GPLv3; the documentation is licensed under CC BY-SA 4.0.