SSD Nodes Learn Hosting plans →
নির্দেশিকা Matt Connorদ্বারা Matt Connor

Ubuntu VPS-এ FreshRSS ইনস্টল করার নিয়ম

Ubuntu 24.04 সার্ভারে Apache, PHP 8.3 এবং MariaDB ব্যবহার করে FreshRSS সেটআপ করুন। এই গাইডে ভার্চুয়াল হোস্ট কনফিগারেশন, cron job এবং মোবাইল API ব্যবহারের সঠিক পদ্ধতি দেওয়া হলো।

আপনি যা তৈরি করছেন

একটি self-hosted RSS reader হলো এমন একটি feed reader, যা আপনার মালিকানাধীন সার্ভারে চলে। তাই অন্য কেউ এটি বন্ধ করতে বা আপনাকে কী দেখানো হবে তা পরিবর্তন করতে পারে না। এই গাইডে Ubuntu 24.04 VPS-এ FreshRSS স্থাপন করা হবে: সামনে Apache, এর পেছনে PHP, data সংরক্ষণের জন্য MariaDB এবং নতুন article আনতে একটি cron job। RSS (really simple syndication) হলো এমন file format, যা কোনো site প্রকাশ করে যাতে software তার article পড়তে পারে। FreshRSS হলো PHP application, যা এই file-গুলো সংগ্রহ করে, article সংরক্ষণ করে এবং একটি web interface ও API (application programming interface) দেয়, যার সঙ্গে phone app-গুলো যোগাযোগ করে।

Installation-এর ধাপগুলো সংক্ষিপ্ত: একটি release unpack করুন, database তৈরি করুন, একটি virtual host লিখুন, command line installer চালান, তারপর cli/create-user.php দিয়ে account তৈরি করুন। নিচের অধিকাংশ কাজ installation-এর পরের বিষয়, যেখানে সাধারণত ভুল হয়। এর মধ্যে আছে refresh job, mobile API-এর জন্য encoded slash এবং file ownership।

October 21, 2026-এ প্রকাশিত FreshRSS 1.30.4 হলো October 29, 2026 অনুযায়ী বর্তমান release। এটির জন্য PHP 8.1 বা নতুন সংস্করণ প্রয়োজন। Ubuntu 24.04-এ PHP 8.3 থাকে, তাই distribution package-ই যথেষ্ট। আপনার 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 চালু না হয়, তবে সাধারণত অন্য কোনো প্রসেস ইতিমধ্যে পোর্ট 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 -m ব্যবহার করে PHP বর্তমানে কী কী লোড করেছে তা যাচাই করুন। কোনো এক্সটেনশন অনুপস্থিত থাকলে তা ইনস্টলার শুরু হওয়া আটকায় না। এটি ইনস্টলারের রিকোয়ারমেন্ট স্ক্রিনে একটি লাল রঙের লাইনের মাধ্যমে এক্সটেনশনটির নাম প্রদর্শন করে, যা সমস্যার কারণ খুঁজে বের করার জন্য বিভ্রান্তিকর হতে পারে। তাই এখনই নিশ্চিত হয়ে নিন। Apache রিস্টার্ট করা জরুরি, কারণ libapache2-mod-php PHP-কে Apache প্রসেসের ভেতরেই রাখে। ফলে নতুন ইনস্টল করা কোনো এক্সটেনশন রিস্টার্ট না করা পর্যন্ত ওয়েব সার্ভারের কাছে অদৃশ্য থাকে।

রিলিজ ডাউনলোড করুন

FreshRSS ডিফল্ট web root-এর বাইরে ইনস্টল করুন এবং 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 এ বিষয়ে কঠোর: web server user পুরো tree-এর মালিক হবে, 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 হিসেবে চলে এবং root-এর মালিকানাধীন directory-তে www-data লিখতে পারে না।

ডেটাবেস তৈরি করুন

FreshRSS SQLite, MariaDB, MySQL এবং PostgreSQL সমর্থন করে। SQLite-এর জন্য php-sqlite3 extension প্রয়োজন, কিন্তু কোনো database server setup প্রয়োজন হয় না। এটি প্রতিটি ব্যবহারকারীর data আলাদা data/users/_user_/db.sqlite file-এ সংরক্ষণ করে। ব্যবহারকারী যোগ করলে তাদের write একই shared SQLite file-এ জমা হয় না; এই guide-এ 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;"

utf8mb4 ব্যবহার করুন, utf8 নয়। Feed-এ emoji এবং non-Latin script থাকে, কিন্তু পুরোনো three-byte utf8 encoding four-byte character সংরক্ষণ করতে পারে না। MariaDB-এর default strict mode-এ unsupported character থাকলে error হয়। Truncation নির্ভর করে SQL mode এবং IGNORE-এর মতো statement option-এর ওপর।

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 যোগ করুন

আপনি এই সাইটে একটি পাসওয়ার্ড টাইপ করতে যাচ্ছেন, তাই প্রথমে একটি সার্টিফিকেট সংগ্রহ করুন। সার্ভারের দিকে একটি A রেকর্ড পয়েন্ট করুন, তারপর 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 হিসেবে লগ ইন করুন।

নিজে থেকে feed refresh না হওয়ার কারণ

আপনি নির্দেশ না দেওয়া পর্যন্ত কোনো scheduler আপনার feed poll করে না। FreshRSS খুললে feed fetching-এর জন্য কোনো schedule তৈরি হয় না; scheduler না থাকলে article হাতে fetch করতে navigation menu-র update link ব্যবহার করুন। এর সমাধান হলো এই কাজের জন্য project যে 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

বিশ মিনিটের schedule যুক্তিসংগত। তবে প্রতিটি feed-এর refresh interval এখনও প্রযোজ্য: default হলো এক ঘণ্টা, এবং পৃথক feed-এর জন্য সর্বনিম্ন পনেরো মিনিটের interval সমর্থিত। প্রথমে এটি হাতে একবার চালান:

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

স্বাভাবিক output-এ refresh run-এর তথ্য দেখা যায় এবং PHP error ছাড়াই run শেষ হয়; article যোগ বা update হলে feed-এর নাম দেখা যায়। একেবারেই কোনো output না থাকলে PHP-এর error output এবং FreshRSS logs পরীক্ষা করুন; শুধু নীরবতা দেখে 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 app ব্যবহার করে। দুটি শর্ত পূরণ হতে হবে। Authentication settings-এ "Allow API access" চালু থাকতে হবে; উপরের --api-enabled flag ইতিমধ্যে এটি সেট করেছে। আপনার profile-এ API password field-এ একটি মান থাকতে হবে। এই password আপনার login password থেকে ইচ্ছাকৃতভাবে আলাদা, কারণ ফোন হারিয়ে যাওয়ার ঝুঁকি বেশি।

সার্ভারের configuration check স্বয়ংক্রিয়ভাবে চালাতে https://rss.example.com/api/-এ যান। সঠিকভাবে সেটআপ হলে PASS ফলাফল দেখাবে। Check ব্যর্থ হলে virtual host-এর AllowEncodedSlashes On setting এবং প্রদর্শিত error পরীক্ষা করুন। app-এ 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।

ব্যাকআপ এবং আপগ্রেড

আপনার state দুটি জিনিসে সংরক্ষিত থাকে: database এবং /srv/freshrss/data/। প্রথমটি sudo mysqldump freshrss > freshrss.sql দিয়ে dump করুন, দ্বিতীয়টির একটি copy তৈরি করুন, এবং দুটিই এই server ছাড়া অন্য কোথাও সংরক্ষণ করুন। আপনার subscription list-ও মাঝে মাঝে OPML export করার মতো গুরুত্বপূর্ণ, কারণ এই file আপনার feed list-কে OPML সমর্থনকারী অন্য reader-এ স্থানান্তর করতে পারে। তবে এতে FreshRSS-এর নির্দিষ্ট settings, যেমন refresh frequency, credentials, user agent বা XPath web scraping rules, সংরক্ষিত হয় না; সেগুলোও সংরক্ষণ করতে SQLite export ব্যবহার করুন।

আপগ্রেডের সময় একই directory-র ওপর নতুন release unpack করতে হয় এবং ownership commands আবার চালাতে হয়। Project-এর version-by-version upgrade path অনুসরণ করুন এবং প্রতিটি ধাপের পরে FreshRSS যাচাই করুন। পরের page load-এর সময় FreshRSS নিজস্ব database migration প্রয়োগ করে। আগে backup নিন, কারণ যে database restore করা যায় না তাতে migration ব্যর্থ হলে অবস্থা পুনরুদ্ধার করা সম্ভব নয়। 1.29.1-এর মতো পুরোনো tarball থেকে install করলে 1.30.4-এ আপগ্রেড করুন: 1.30.x security release-গুলো authentication change-এর সময় session ID rotation এবং ZIP import-এর সীমা যুক্ত করে, আর 1.30.4 গুরুতর PHP vulnerability-এর জন্য alternative Alpine Docker image-গুলোও update করে। Reader চালানো কম ঝুঁকিপূর্ণ, এবং যে জিনিসগুলো self-host করা উপযোগী তার তালিকা ধরে এগোলে এটি শুরু করার জন্য ভালো service।

FAQ

আমার feed কেবল FreshRSS খুললে আপডেট হয় কেন?

পেজ খুললে feed fetching নির্ধারিত হয় না; scheduler ছাড়া আপডেট link ব্যবহার করে manual refresh করুন। www-data user হিসেবে app/actualize_script.php চালানোর cron line যোগ করুন, তারপর script-টি একবার হাতে চালিয়ে এর output পড়ুন। কোনো output না থাকলে PHP-এর error output এবং FreshRSS log পরীক্ষা করুন। এরপর যাচাই করুন, cron user-এর data/-এ write access আছে কি না।

আমার mobile app সংযোগ করতে পারে না, কিন্তু website কাজ করে। কেন?

Google Reader API request path-এর মধ্যে encoded slash (%2F) ব্যবহার করে, কিন্তু Apache ডিফল্টভাবে সেগুলো reject করে। virtual host-এর মধ্যে AllowEncodedSlashes On যোগ করে Apache reload করুন। https://rss.example.com/api/ খুলে পরিবর্তনটি যাচাই করুন; সেখানে automatic configuration check-এর ফল হিসেবে PASS দেখানোর কথা। এছাড়া আপনার profile-এ API password সেট করা আছে কি না পরীক্ষা করুন, কারণ এটি 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 command-এর মাধ্যমে দুটির মধ্যে পরিবর্তন করা যায়। তাই এটি স্থায়ী সিদ্ধান্ত নয়।

Installer configuration লেখার সময় ব্যর্থ হয়। সমস্যা কী?

Apache-এর অধীনে PHP www-data হিসেবে চলে, এবং এই user root-এর মালিকানাধীন directory-তে লিখতে পারে না। sudo chown -R www-data:www-data /srv/freshrss এবং sudo chmod -R g+w /srv/freshrss/data আবার চালান, তারপর installer পুনরায় শুরু করুন। আপনি যদি ইতিমধ্যে root হিসেবে command line installer চালিয়ে থাকেন, retry করার আগে data/-এর অধীনে এটি তৈরি করা file-গুলোর ownership সংশোধন করুন।

একটি self-hosted RSS reader-এর জন্য কতটা server resource প্রয়োজন?

খুব কম। FreshRSS সীমিত hardware-এ চলার জন্য তৈরি, তবে resource use আপনার feed, article-এর আকার এবং retention setting-এর ওপর নির্ভর করে। retention বাড়লে disk usage-ও বাড়ে। তাই সবকিছু চিরদিন রাখার পরিবর্তে archiving setting-এ article purge policy নির্ধারণ করুন।

এই লেখাটি কি কাজে লেগেছে?