Freedbin 🍔
Feedbin is a simple, fast and nice looking RSS reader - this fork provides a version intended for users who want to host their own copy of it for free, that can be run anywhere with Docker.
Requirements
- Docker
- docker-compose
Installation
wget https://raw.githubusercontent.com/thomas-illiet/freedbin/master/docker-compose.yml
- Set config values in the
docker-compose.yml
file SECRET_KEY_BASE
- Rails Secret Key which needs to be set for security reasons
- Set config values in the
docker-compose up
- Access the app from
localhost:9292
(first request can take a little while)
All the minimum necessary config parameters required for it to run are set in the Dockerfile. All the config parameters required for interconnectivity with the db etc, are specified in the docker compose file.
The container images are hosted on dockerhub:
Differences to the original
- Will work without a payment system like stripe
- Doesn't require HTTPS to be enabled (for if you are using at home, or from behind a reverse proxy)
- API is served from the main domain rather than an API subdomain.
- Use open source fonts
Release management
I build daily images of feedbin, you have 4 type of release
- Latest : Every day
- Weekly : Every sunday
- Monthly : Every month
And on the latest build, i added latest git head in docker tag :)
Contributing
Feel free to file PRs for features or fixes you think are specifically useful to the self-hosted version, but if it's generally applicable then contribute to the original Feedbin project which will be merged into this fork periodically.