From 942c70c25fd8e91944d5a61910babc72a633fe73 Mon Sep 17 00:00:00 2001 From: saitejx08 Date: Fri, 7 Nov 2025 12:40:41 +0530 Subject: [PATCH] Documentation of self hosted server --- selfhosted/40369.md | 138 ++++++++++++++++++++++++++++++++++++++++++++ 1 file changed, 138 insertions(+) create mode 100644 selfhosted/40369.md diff --git a/selfhosted/40369.md b/selfhosted/40369.md new file mode 100644 index 0000000..b27bb37 --- /dev/null +++ b/selfhosted/40369.md @@ -0,0 +1,138 @@ +DOCUMENTATION BY A SAI TEJA - 2400040369 + +FreshRSS — Self-Hosted RSS Feed Reader +Overview + +FreshRSS is a free, open-source, self-hosted RSS feed aggregator that allows users to collect and read updates from multiple websites, blogs, YouTube channels, and online publications in one unified dashboard. + +Instead of visiting individual websites, FreshRSS automatically fetches new content via RSS or Atom feeds and displays them in a clean, ad-free, chronological interface. It works entirely on your own server — giving you full control, privacy, and offline access to your subscribed content. + +Key Features + +1 Centralized Reading – View all news, articles, and video updates in one dashboard. + +2 Automatic Feed Updates – Fetches new content periodically via cron or background jobs. + +3 Multi-User Support – Multiple accounts can be created on the same instance. + +4 API Support – Compatible with third-party apps such as Reeder, FeedMe, and NetNewsWire. + +5 Extensible & Customizable – Supports themes, extensions, and custom CSS. + +6 Offline & Ad-Free – Stores content locally, free from ads or tracking. + +7 Lightweight & Fast – Works even on low-end hardware (like Raspberry Pi). + +Use Case Example + +Suppose you regularly follow: + +Tech blogs like Ars Technica or The Verge, + +YouTube channels such as Linus Tech Tips, + +Open-source project updates from GitHub releases. + +Instead of visiting each separately, you simply subscribe to their feed URLs in FreshRSS. +FreshRSS then automatically fetches and displays all new articles and videos — in one place, sorted by date or category. + +- Installation (via Docker – easiest method) +1️⃣ Install Docker and Docker Compose +curl -fsSL https://get.docker.com | sh +sudo usermod -aG docker $USER +# logout & log back in after this + + +Verify: + +docker --version +docker compose version + +2️⃣ Create the Project Directory +mkdir ~/freshrss +cd ~/freshrss + +3️⃣ Create a Docker Compose File + +Create and edit: + +nano docker-compose.yml + + +Paste: + +version: "3.9" +services: + freshrss: + image: freshrss/freshrss:latest + container_name: freshrss + ports: + - "8080:80" + volumes: + - ./data:/var/www/FreshRSS/data + - ./extensions:/var/www/FreshRSS/extensions + restart: unless-stopped + + +Save and exit (Ctrl + O, Enter, Ctrl + X). + +4️⃣ Start FreshRSS +docker compose up -d + + +Check if it’s running: + +docker ps + + +If it shows freshrss running → ✅ success. + +5️⃣ Open in Browser + +Go to: + +http://localhost:8080 + + +You’ll see the FreshRSS setup wizard. + +Follow the on-screen steps: + +Choose language → Next + +Select database → SQLite (simplest) + +Create an admin account → Next + +Login → and start adding feeds! + +6️⃣ Add Feeds (Example: YouTube Channel) + +Go to the YouTube channel → view page source → find channel_id. + +Create a feed URL: + +https://www.youtube.com/feeds/videos.xml?channel_id=UCX6OQ3DkcsbYNE6H8uQQuVA + + +Paste it into FreshRSS → Subscription Management → Add a feed. + +Assign to category (optional) → Done. + +7️⃣ Auto-Start on Boot + +Docker handles this automatically thanks to: + +restart: unless-stopped + + +Your FreshRSS container will start every time the system boots — no manual commands needed. + +🧠 Summary +Feature Description +Purpose Aggregates news & updates from multiple sources via RSS +Type Self-hosted web application +Stack PHP / SQLite (or MySQL) / Docker +Access Web browser, mobile RSS apps +Advantages Privacy, offline access, centralization, speed +Setup Time ~5–10 minutes with Docker \ No newline at end of file