SSD Nodes Learn Hosting plans →
मार्गदर्शक Matt Connorद्वारे Matt Connor

Ubuntu VPS वर FreshRSS कसे इन्स्टॉल करावे

Ubuntu 24.04 वर Apache, PHP आणि MariaDB वापरून FreshRSS सेटअप करण्याची संपूर्ण प्रक्रिया. यामध्ये व्हर्च्युअल होस्ट कॉन्फिगरेशन, डेटाबेस सेटअप आणि क्रॉन जॉब सेट करण्याच्या पायऱ्या आहेत.

तुम्ही काय तयार करत आहात

Self-hosted RSS reader हा तुमच्या मालकीच्या server वर चालणारा feed reader आहे. त्यामुळे कोणीही तो बंद करू शकत नाही किंवा तो तुम्हाला दाखवत असलेली माहिती बदलू शकत नाही. या मार्गदर्शकात Ubuntu 24.04 VPS वर FreshRSS स्थापित केले आहे: समोर Apache, त्यामागे PHP, storage साठी MariaDB आणि नवीन articles आणण्यासाठी एक cron job. RSS (really simple syndication) हे एखादी site तिचे articles software ला वाचता यावेत म्हणून प्रकाशित करते ते file format आहे. FreshRSS हे ते files गोळा करणारे, articles जतन करणारे आणि web interface तसेच API (application programming interface) उपलब्ध करून देणारे PHP application आहे. Phone apps या API शी संवाद साधतात.

Installation स्वतः लहान आहे: release unpack करा, database तयार करा, एक virtual host लिहा, command line installer चालवा आणि cli/create-user.php वापरून account तयार करा. त्यानंतरची कामेच बहुतेक वेळा चुकीची केली जातात. त्यात refresh job, mobile API साठी encoded slashes आणि file ownership यांचा समावेश आहे.

October 21, 2026 रोजी प्रकाशित झालेले FreshRSS 1.30.4 हे October 29, 2026 रोजीचे current release आहे आणि त्यासाठी PHP 8.1 किंवा त्यानंतरची आवृत्ती आवश्यक आहे. Ubuntu 24.04 मध्ये PHP 8.3 उपलब्ध आहे. त्यामुळे distribution packages पुरेसे आहेत आणि third party PHP repository ची आवश्यकता नाही.

LAMP स्टॅक कार्यरत असल्याची खात्री करा

FreshRSS हे एक सामान्य PHP ॲप्लिकेशन आहे, त्यामुळे त्याला इतर ॲप्लिकेशन्सप्रमाणेच पायाभूत सुविधांची आवश्यकता असते. जर तुम्ही अद्याप ती तयार केली नसेल, तर प्रथम Ubuntu 24.04 साठी LAMP स्टॅक सेटअप पूर्ण करा आणि त्यानंतर येथे परत या. थोडक्यात सांगायचे तर:

sudo apt update
sudo apt install -y apache2 mariadb-server php libapache2-mod-php
sudo systemctl enable --now apache2 mariadb

systemctl status apache2 ने active (running) दर्शवले पाहिजे. जर Apache सुरू होत नसेल, तर त्याचे सामान्य कारण म्हणजे दुसरी एखादी प्रक्रिया आधीच port 80 वापरत असणे, आणि sudo ss -ltnp | grep :80 त्या प्रक्रियेचे नाव दर्शवते.

FreshRSS साठी आवश्यक PHP एक्स्टेंशन्स

FreshRSS साठी libxml, cURL, JSON, PDO_MySQL, PCRE आणि ctype ही एक्स्टेंशन्स अनिवार्य आहेत. याव्यतिरिक्त, mbstring, iconv, Zlib, ZipArchive आणि 32-बिट सिस्टिमवर GMP असणे आवश्यक आहे. Ubuntu वर ही एक्स्टेंशन्स खालीलप्रमाणे डिस्ट्रिब्युशन पॅकेजेसद्वारे मिळतात:

sudo apt install -y php-curl php-mbstring php-xml php-zip php-mysql php-intl php-gmp
sudo systemctl restart apache2

PHP ने नेमकी कोणती एक्स्टेंशन्स लोड केली आहेत हे तपासण्यासाठी php -m वापरा. एखादे एक्स्टेंशन गहाळ असल्यास इन्स्टॉलर सुरू होण्यापासून थांबत नाही. ते थेट रिक्वायरमेंट्स स्क्रीनवर लाल रंगात त्या एक्स्टेंशनचे नाव दाखवून थांबते, जेथे समस्या शोधणे गोंधळात टाकणारे ठरू शकते, म्हणून आताच खात्री करून घ्या. Apache रीस्टार्ट करणे महत्त्वाचे आहे कारण libapache2-mod-php हे PHP ला Apache प्रोसेसमध्ये ठेवते, त्यामुळे नवीन इन्स्टॉल केलेले एक्स्टेंशन रीस्टार्ट केल्याशिवाय वेब सर्व्हरला दिसत नाही.

रिलीज डाउनलोड करा

FreshRSS हे default web root च्या बाहेर install करा आणि Apache कडून त्याकडे निर्देश करा. Application directory ही document root पासून वेगळी ठेवल्यास HTTP द्वारे केवळ public folder उपलब्ध राहतो.

cd /tmp
curl -fsSLO https://github.com/FreshRSS/FreshRSS/archive/refs/tags/1.30.4.tar.gz
tar xzf 1.30.4.tar.gz
sudo mv FreshRSS-1.30.4 /srv/freshrss

आता permissions सेट करा. FreshRSS documentation याबाबत स्पष्ट आहे: संपूर्ण tree चा मालक web server user असावा, group ला प्रत्येक file वाचता आली पाहिजे आणि group ला ./data/ मध्ये लिहिता आले पाहिजे.

sudo chown -R www-data:www-data /srv/freshrss
sudo chmod -R g+r /srv/freshrss
sudo chmod -R g+w /srv/freshrss/data

ही पायरी वगळल्यास installer configuration लिहिताना अयशस्वी होतो, कारण PHP हे www-data म्हणून चालते आणि www-data ला root च्या मालकीच्या directory मध्ये लिहिता येत नाही.

डेटाबेस तयार करा

FreshRSS SQLite, MariaDB, MySQL आणि PostgreSQL ला समर्थन देते. SQLite साठी php-sqlite3 extension आवश्यक आहे; मात्र database server setup आवश्यक नसतो. प्रत्येक वापरकर्त्याचा डेटा स्वतंत्र data/users/_user_/db.sqlite file मध्ये साठवला जातो. वापरकर्ते जोडल्यावर त्यांचे writes एका shared SQLite file मध्ये साठवले जात नाहीत. या मार्गदर्शकात LAMP stack चा भाग म्हणून MariaDB वापरले आहे.

sudo mariadb -e "CREATE DATABASE freshrss CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;"
sudo mariadb -e "CREATE USER 'freshrss'@'localhost' IDENTIFIED BY 'ReplaceThisPassword';"
sudo mariadb -e "GRANT ALL PRIVILEGES ON freshrss.* TO 'freshrss'@'localhost';"
sudo mariadb -e "FLUSH PRIVILEGES;"

utf8 ऐवजी utf8mb4 वापरा. Feeds मध्ये emoji आणि non-Latin scripts असतात. जुन्या three byte utf8 encoding मध्ये four byte characters साठवता येत नाहीत. MariaDB च्या default strict mode मध्ये unsupported characters मुळे error येतो. Truncation हे SQL mode आणि IGNORE सारख्या statement options वर अवलंबून असते.

Apache व्हर्च्युअल होस्ट

पब्लिक डिरेक्टरी p/ आहे, ट्रीची सुरुवात नाही. डेटाबेस पासवर्ड असलेली कॉन्फिगरेशन फाईल यासह इतर सर्व काही डॉक्युमेंट रूटच्या वर असते, जिथे Apache ती कधीही सर्व्ह करत नाही.

<VirtualHost *:80>
	ServerName rss.example.com
	DocumentRoot /srv/freshrss/p/

	<Directory /srv/freshrss/p>
		AllowOverride AuthConfig FileInfo Indexes Limit
		Require all granted
	</Directory>

	ErrorLog ${APACHE_LOG_DIR}/freshrss_error.log
	CustomLog ${APACHE_LOG_DIR}/freshrss_access.log combined

	AllowEncodedSlashes On
</VirtualHost>

ती /etc/apache2/sites-available/freshrss.conf म्हणून सेव्ह करा आणि ती इनेबल करा:

sudo a2enmod rewrite
sudo a2ensite freshrss
sudo a2dissite 000-default
sudo apache2ctl configtest
sudo systemctl reload apache2

configtest ने Syntax OK प्रिंट केले पाहिजे. AllowEncodedSlashes On ऐच्छिक वाटते पण ते तसे नाही: Google Reader API मध्ये %2F असलेले फीड आयडेंटिफायर्स असतात आणि या डिरेक्टिव्हशिवाय Apache त्यांना नाकारते, त्यामुळे वेब इंटरफेस व्यवस्थित चालत असतानाही मोबाईल ॲप्स सिंक होण्यास अपयशी ठरतात.

लॉगिन करण्यापूर्वी HTTPS जोडा

तुम्ही या साइटवर पासवर्ड टाइप करणार आहात, त्यामुळे प्रथम एक प्रमाणपत्र (certificate) मिळवा. सर्व्हरवर एक A record पॉइंट करा, त्यानंतर Ubuntu वर Apache साठी Certbot सेटअप फॉलो करा आणि sudo certbot --apache -d rss.example.com रन करा. Certbot पोर्ट 443 साठी व्हर्च्युअल होस्ट पुन्हा लिहितो आणि रिडायरेक्ट जोडतो. curl -I https://rss.example.com/ सह खात्री करा, ज्याने 200 किंवा लॉगिन पेजवर रिडायरेक्ट मिळायला हवे.

कमांड लाईनवरून इंस्टॉलर चालवणे

FreshRSS मध्ये ब्राउझर-आधारित इंस्टॉलर उपलब्ध आहे, परंतु कमांड लाईन आवृत्ती पुन्हा वापरण्यायोग्य आहे आणि तुम्ही नेमके काय निवडले याची नोंद ठेवते.

sudo -u www-data php /srv/freshrss/cli/do-install.php \
  --default-user admin --auth-type form --environment production \
  --base-url https://rss.example.com --language en --api-enabled \
  --db-type mysql --db-host localhost --db-user freshrss \
  --db-password 'ReplaceThisPassword' --db-base freshrss
sudo -u www-data php /srv/freshrss/cli/create-user.php \
  --user admin --password 'a-long-passphrase' --api-password 'a-different-passphrase'

दोन्ही कमांड्स www-data म्हणून चालवा. त्या root म्हणून चालवल्यास तयार होणाऱ्या कॉन्फिगरेशन फाईल्सची मालकी root कडे जाते, ज्यामुळे नंतर वेब इंटरफेसमध्ये कोणतीही सेटिंग सेव्ह करणे अयशस्वी होते. --environment production देखील महत्त्वाचे आहे, कारण डेव्हलपमेंट सेटिंगमुळे PHP नोटिसेस पेजवर दिसू लागतात.

https://rss.example.com/ लोड करा आणि admin म्हणून लॉग इन करा.

फीड आपोआप refresh का होत नाहीत

तुम्ही तसे सांगितल्याशिवाय कोणतीही प्रक्रिया तुमचे फीड poll करत नाही. FreshRSS उघडल्याने फीड fetch करण्याचे वेळापत्रक तयार होत नाही; scheduler नसल्यास लेख manually fetch करण्यासाठी navigation menu मधील update link वापरा. यासाठी प्रकल्पासोबत दिलेले script, app/actualize_script.php, cron मधून चालवा.

sudo crontab -u www-data -e

एक ओळ जोडा:

*/20 * * * * php /srv/freshrss/app/actualize_script.php > /tmp/FreshRSS.log 2>&1

वीस मिनिटांचे वेळापत्रक योग्य आहे. मात्र प्रत्येक फीडचा refresh interval लागू राहतो: default एक तास आहे आणि स्वतंत्र फीडसाठी किमान पंधरा मिनिटांचा interval ठेवता येतो. प्रथम ते manually एकदा चालवून पाहा:

sudo -u www-data php /srv/freshrss/app/actualize_script.php

यशस्वी output मध्ये refresh run नोंदवला जातो आणि शेवटी PHP error नसतो; लेख जोडले किंवा update केले गेल्यास फीडची नावे दिसतात. काहीही output दिसत नसेल, तर PHP चे error output आणि FreshRSS logs तपासा; केवळ output नसल्यामुळे cron user हे कारण आहे असे ठरवता येत नाही. data/ वर permission error आल्यास ownership आणि write permissions तपासा.

तुमचे पहिले फीड्स जोडा

इंटरफेसच्या वरच्या डाव्या कोपऱ्यातील प्लस बटण वापरा, साइटचा पत्ता पेस्ट करा आणि FreshRSS तुमच्यासाठी फीड लिंक शोधून काढेल. बहुतेक साइट्स जरी त्याची जाहिरात करत नसल्या तरीही एक फीड प्रकाशित करतात, जे सहसा /feed, /rss किंवा /atom.xml वर असते. कॅटेगरी म्हणजे फोल्डर्स असतात आणि एका फीडला एका फोल्डरमधून दुसऱ्या फोल्डरमध्ये हलवणे सोपे असते.

जर तुम्ही दुसऱ्या रीडरवरून येत असाल, तर तिथे एक OPML फाईल एक्सपोर्ट करा आणि ती सबस्क्रिप्शन मॅनेजमेंट पेजवर इम्पोर्ट करा. OPML (outline processor markup language) हे फीड लिस्टचे मानक फॉरमॅट आहे आणि प्रत्येक चांगला रीडर याला सपोर्ट करतो. मोठ्या प्रमाणात इम्पोर्ट केल्यास पहिल्या रिफ्रेशला वेळ लागतो कारण प्रत्येक फीड एकदा फेच केले जाते, त्यामुळे गतीचा अंदाज घेण्यापूर्वी पहिल्या cron रनला पुरेसा वेळ द्या.

तुमच्या फोनवर वाचा

FreshRSS Google Reader API शी सुसंगत आहे आणि अनेक RSS अॅप्स त्याला समर्थन देतात. दोन अटी पूर्ण असणे आवश्यक आहे. Authentication settings मध्ये "Allow API access" सुरू असणे आवश्यक आहे. वरील --api-enabled flag ने ते आधीच सुरू केले आहे. तुमच्या profile मध्ये API password field मध्ये मूल्य असणे आवश्यक आहे. हा password तुमच्या login password पेक्षा वेगळा ठेवला आहे, कारण फोन हरवण्याची शक्यता जास्त असते.

सर्व्हर configuration checks स्वयंचलितपणे चालवण्यासाठी https://rss.example.com/api/ उघडा. Configuration योग्य असल्यास PASS दिसेल. Check अयशस्वी झाल्यास virtual host मधील AllowEncodedSlashes On setting आणि दाखवलेली error तपासा. अॅपमध्ये server address म्हणून https://rss.example.com/api/greader.php, username म्हणून तुमचा FreshRSS user आणि password म्हणून API password द्या.

Docker चा पर्याय

जर तुम्हाला PHP आणि Apache स्वतः हाताळायचे नसतील, तर हा प्रकल्प एक अधिकृत freshrss/freshrss इमेज प्रकाशित करतो. एक compose फाईल तुम्हाला ॲप्लिकेशन आणि त्याचा डेटाबेस एकत्रितपणे उपलब्ध करून देते. यामध्ये नेहमीचाच तडजोडीचा मुद्दा असतो: होस्टवर कमी घटक असतात, परंतु काही बिघडल्यास डीबग करण्यासाठी एक अतिरिक्त स्तर वाढतो आणि TLS (transport layer security) साठी अजूनही रिव्हर्स प्रॉक्सीची आवश्यकता असते. जर हे तुम्हाला अधिक सोयीचे वाटत असेल, तर VPS साठी Docker Compose ची मूलभूत माहिती मध्ये फाईल फॉरमॅटची माहिती दिली आहे आणि cron लाईन docker exec --user www-data freshrss php ./app/actualize_script.php अशी होईल.

बॅकअप आणि अपग्रेड

तुमची स्थिती दोन गोष्टींमध्ये साठवली जाते: database आणि /srv/freshrss/data/. पहिल्याचा dump sudo mysqldump freshrss > freshrss.sql ने घ्या आणि दुसरी गोष्ट कॉपी करा. दोन्ही प्रती या server व्यतिरिक्त इतरत्र ठेवा. तुमची subscription list अधूनमधून OPML export करण्यासही योग्य आहे, कारण OPML ला support करणाऱ्या इतर readers मध्ये ही file तुमची feed list transfer करते. मात्र ती FreshRSS-specific settings जतन करत नाही. यामध्ये refresh frequency, credentials, user agent आणि XPath web scraping rules यांचा समावेश आहे. त्या settings जतन करण्यासाठी SQLite export वापरा.

Upgrade करण्यासाठी त्याच directory वर नवीन release unpack करा आणि ownership commands पुन्हा चालवा. Project च्या version-by-version upgrade path चे पालन करा आणि प्रत्येक टप्प्यानंतर FreshRSS पडताळा. पुढील page load वेळी FreshRSS स्वतःच्या database migrations लागू करते. आधी backup घ्या. तुम्ही restore करू शकत नसलेल्या database वरील migration अयशस्वी झाल्यास स्थिती सुधारता येत नाही. तुम्ही 1.29.1 सारख्या जुन्या tarball मधून install केले असल्यास 1.30.4 वर जा. 1.30.x security releases मध्ये authentication changes वेळी session ID rotation आणि ZIP imports साठी bounds समाविष्ट आहेत. तसेच, 1.30.4 मध्ये गंभीर PHP vulnerabilities साठी alternative Alpine Docker images अपडेट केल्या आहेत. Reader ही कमी जोखमीची service आहे आणि self-hosting साठी योग्य गोष्टींच्या यादीत काम करत असल्यास सुरुवात करण्यासाठी चांगली candidate आहे.

FAQ

माझे feeds FreshRSS उघडल्यावरच अपडेट का होतात?

पेज उघडल्याने feed fetching schedule होत नाही; scheduler नसल्यास refresh करण्यासाठी update link वापरा. www-data user म्हणून app/actualize_script.php चालवणारी cron line जोडा, त्यानंतर script एकदा manually चालवून त्याचे output वाचा. काही output दिसत नसेल, तर PHP चे error output आणि FreshRSS logs तपासा. त्यानंतर cron user कडे data/ वर write access आहे का ते पडताळा.

माझे mobile app connect होत नाही, पण website चालते. असे का?

Google Reader API request paths मध्ये encoded slashes (%2F) वापरते आणि Apache ते default ने reject करते. Virtual host मध्ये AllowEncodedSlashes On जोडा आणि Apache reload करा. https://rss.example.com/api/ उघडून बदलाची खात्री करा; तेथे automatic configuration check ने PASS दाखवले पाहिजे. API password तुमच्या profile मध्ये सेट केला आहे का हेही तपासा, कारण तो login password पेक्षा वेगळा असतो.

SQLite वापरावे की MariaDB?

SQLite ला php-sqlite3 extension आवश्यक आहे; मात्र database server किंवा database password व्यवस्थापित करण्याची गरज नसते. प्रत्येक user साठी स्वतंत्र SQLite database file तयार होते. त्यामुळे दुसरा user जोडल्यावर एका shared file वर contention निर्माण होत नाही आणि MariaDB आवश्यक राहत नाही. तुमच्या LAMP stack मध्ये database server वापरायचा असल्यास MariaDB निवडा. नंतर export आणि import commands द्वारे त्यांच्यात बदल करणे शक्य आहे. त्यामुळे हा कायमस्वरूपी निर्णय नाही.

Installer configuration लिहिताना fail होतो. काय चूक आहे?

Apache अंतर्गत PHP www-data म्हणून चालते आणि त्या user कडे root च्या मालकीच्या directory मध्ये write करण्याची परवानगी नसते. sudo chown -R www-data:www-data /srv/freshrss आणि sudo chmod -R g+w /srv/freshrss/data पुन्हा चालवा, त्यानंतर installer पुन्हा सुरू करा. तुम्ही command line installer आधीच root म्हणून चालवला असल्यास, पुन्हा प्रयत्न करण्यापूर्वी data/ अंतर्गत त्याने तयार केलेल्या files ची ownership दुरुस्त करा.

Self-hosted RSS reader साठी किती server resources आवश्यक आहेत?

फार कमी. FreshRSS मर्यादित hardware वर चालण्यासाठी डिझाइन केलेले आहे. मात्र resource वापर तुमच्या feeds, article sizes आणि retention settings वर अवलंबून असतो. Retention वाढल्याने disk usage वाढतो. त्यामुळे सर्व articles कायम ठेवण्याऐवजी archiving settings मध्ये article purge policy सेट करा.

हा लेख उपयुक्त होता का?