Skip to content
Branch: master
Clone or download
Pull request Compare This branch is 29 commits ahead, 132 commits behind feedbin:master.
Latest commit 09bb2a8 Feb 25, 2019

README.md

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/rach-sharp/freedbin/master/docker-compose.yml
  • Set config values in the docker-compose.yml file
  • 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

Batteries Included

  • 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

Optional Extras

  • When ANALYTICS_GTAG environment variable is set, Google Analytics will be enabled

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.

Roadmap

  • Restricting signups to be admin-managed.
  • Adding Helm Chart for Kubernetes deployment
You can’t perform that action at this time.