SSD Nodes Learn Hosting plans →
Panduan Matt ConnorOleh Matt Connor

Cara Memasang FreshRSS di VPS Ubuntu 24.04

Panduan memasang FreshRSS 1.30.1 di VPS Ubuntu 24.04 dengan Apache, PHP 8.3, MariaDB, virtual host, cron, dan API aplikasi seluler.

Yang akan Anda bangun

Pembaca RSS yang di-host sendiri adalah pembaca feed yang berjalan di server milik Anda, sehingga tidak ada pihak lain yang dapat mematikannya atau mengubah konten yang ditampilkan. Panduan ini memasang FreshRSS pada VPS Ubuntu 24.04: Apache di depan, PHP di belakangnya, MariaDB untuk penyimpanan, dan satu cron job untuk mengambil artikel baru. RSS (really simple syndication) adalah format file yang diterbitkan situs agar perangkat lunak dapat membaca artikelnya. FreshRSS adalah aplikasi PHP yang mengumpulkan file tersebut, menyimpan artikel, serta menyediakan antarmuka web dan API (application programming interface) yang digunakan aplikasi ponsel.

Proses instalasinya sederhana: ekstrak sebuah rilis, buat database, tulis satu virtual host, jalankan installer command line, lalu buat akun dengan cli/create-user.php. Sebagian besar pekerjaan di bawah ini berkaitan dengan hal-hal yang sering salah setelah instalasi, yaitu refresh job, encoded slashes untuk API seluler, dan kepemilikan file.

FreshRSS 1.30.4, yang diterbitkan pada 21 Oktober 2026, merupakan rilis terbaru per 29 Oktober 2026 dan memerlukan PHP 8.1 atau yang lebih baru. Ubuntu 24.04 menyediakan PHP 8.3, sehingga paket dari distribusi sudah mencukupi dan Anda tidak memerlukan repositori PHP pihak ketiga.

Mulai dari LAMP stack yang berfungsi

FreshRSS adalah aplikasi PHP biasa, sehingga memerlukan fondasi yang sama seperti aplikasi PHP lainnya. Jika Anda belum menyiapkan fondasi tersebut, ikuti penyiapan LAMP stack untuk Ubuntu 24.04 terlebih dahulu, lalu kembali ke sini. Ringkasnya:

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

systemctl status apache2 harus menampilkan active (running). Jika Apache tidak dapat dijalankan, penyebab yang umum adalah proses lain sudah menggunakan port 80, dan sudo ss -ltnp | grep :80 menampilkan proses tersebut.

Ekstensi PHP yang diperlukan FreshRSS

FreshRSS menganggap libxml, cURL, JSON, PDO_MySQL, PCRE, dan ctype sebagai ekstensi wajib. FreshRSS juga memerlukan mbstring, iconv, Zlib, dan ZipArchive, serta GMP pada sistem 32 bit. Di Ubuntu, ekstensi tersebut tersedia sebagai paket distribusi:

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

Periksa ekstensi yang benar-benar dimuat PHP dengan php -m. Ekstensi yang hilang tidak mencegah installer berjalan. Installer akan berhenti pada layar persyaratan dan menampilkan baris merah yang menyebutkan ekstensi tersebut. Menemukan masalah di tahap ini dapat membingungkan, jadi lakukan pemeriksaan sekarang. Restart Apache penting karena libapache2-mod-php menjalankan PHP di dalam proses Apache. Dengan demikian, web server tidak akan melihat ekstensi yang baru diinstal sebelum Apache direstart.

Unduh rilis

Instal FreshRSS di luar web root default, lalu arahkan Apache ke sana. Dengan memisahkan direktori aplikasi dari document root, hanya folder publik yang dapat diakses melalui HTTP.

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

Berikutnya, atur permission sesuai ketentuan dokumentasi FreshRSS: user web server memiliki seluruh tree, group dapat membaca setiap file, dan group dapat menulis ke ./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

Jika langkah ini dilewati, installer gagal saat menulis konfigurasinya karena PHP berjalan sebagai www-data, sedangkan www-data tidak dapat menulis ke direktori yang dimiliki root.

Buat database

FreshRSS mendukung SQLite, MariaDB, MySQL, dan PostgreSQL. SQLite memerlukan ekstensi php-sqlite3, tetapi tidak memerlukan penyiapan server database. SQLite menyimpan data setiap pengguna dalam file data/users/_user_/db.sqlite terpisah. Penambahan pengguna tidak menyimpan data tulis mereka dalam satu file SQLite bersama. Panduan ini menggunakan MariaDB sebagai bagian dari stack LAMP.

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;"

Gunakan utf8mb4, bukan utf8. Feed dapat memuat emoji dan skrip non-Latin. Encoding utf8 lama yang menggunakan tiga byte tidak dapat menyimpan karakter empat byte. Karakter yang tidak didukung menyebabkan error dalam strict mode default MariaDB. Pemotongan data bergantung pada SQL mode dan opsi pernyataan seperti IGNORE.

Virtual host Apache

Direktori publik adalah p/, bukan direktori teratas dalam hierarki. Semua yang lain, termasuk file konfigurasi yang menyimpan kata sandi database Anda, berada di atas document root sehingga Apache tidak akan pernah menyajikannya.

<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>

Simpan sebagai /etc/apache2/sites-available/freshrss.conf, lalu aktifkan:

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

configtest harus menampilkan Syntax OK. AllowEncodedSlashes On tampak opsional, tetapi sebenarnya tidak. Google Reader API mengirimkan pengenal feed yang berisi %2F. Tanpa directive ini, Apache menolaknya sehingga aplikasi seluler gagal melakukan sinkronisasi, sementara antarmuka web tetap berfungsi dengan sempurna.

Tambahkan HTTPS sebelum login

Anda akan memasukkan kata sandi ke situs ini, jadi dapatkan sertifikat terlebih dahulu. Arahkan A record ke server, lalu ikuti penyiapan Certbot untuk Apache di Ubuntu dan jalankan sudo certbot --apache -d rss.example.com. Certbot menulis ulang virtual host untuk port 443 dan menambahkan pengalihan. Konfirmasikan dengan curl -I https://rss.example.com/, yang seharusnya mengembalikan 200 atau pengalihan ke halaman login.

Jalankan installer dari command line

FreshRSS memiliki installer berbasis browser, tetapi versi command line dapat dijalankan berulang kali dan mencatat pilihan Anda secara tepat.

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'

Jalankan keduanya sebagai www-data. Jika dijalankan sebagai root, installer akan membuat file konfigurasi yang dimiliki root. Akibatnya, antarmuka web tidak dapat menyimpan pengaturan apa pun di kemudian hari. --environment production juga penting karena pengaturan pengembangan menampilkan notifikasi PHP pada halaman.

Muat https://rss.example.com/ dan login sebagai admin.

Mengapa feed tidak diperbarui sendiri

Tidak ada proses yang mengambil feed sampai Anda mengaturnya. Membuka FreshRSS tidak menjadwalkan pengambilan feed. Tanpa scheduler, gunakan tautan pembaruan pada menu navigasi untuk mengambil artikel secara manual. Solusinya adalah skrip yang disediakan proyek untuk keperluan ini, app/actualize_script.php, yang dijalankan melalui cron.

sudo crontab -u www-data -e

Tambahkan satu baris:

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

Interval dua puluh menit merupakan jadwal yang wajar, tetapi interval pembaruan setiap feed tetap berlaku. Nilai default-nya adalah satu jam, dan setiap feed mendukung interval hingga minimal lima belas menit. Jalankan skrip tersebut secara manual terlebih dahulu:

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

Output yang normal melaporkan proses pembaruan dan berakhir tanpa error PHP. Nama feed muncul ketika artikel ditambahkan atau diperbarui. Jika tidak menampilkan apa pun, periksa output error PHP dan log FreshRSS. Tidak adanya output saja tidak menunjukkan bahwa pengguna cron adalah penyebabnya. Error izin pada data/ perlu ditindaklanjuti dengan memeriksa kepemilikan dan izin tulis.

Tambahkan feed pertama Anda

Gunakan tombol plus di kiri atas antarmuka, tempelkan alamat situs, dan FreshRSS akan menemukan tautan feed untuk Anda. Sebagian besar situs tetap menerbitkan feed meskipun tidak menampilkannya secara jelas, biasanya di /feed, /rss, atau /atom.xml. Kategori berfungsi sebagai folder, dan Anda dapat memindahkan feed antar-kategori dengan menyeretnya.

Jika Anda menggunakan reader lain, ekspor file OPML dari sana, lalu impor file tersebut pada halaman pengelolaan langganan. OPML (outline processor markup language) adalah format standar untuk daftar feed, dan setiap reader yang layak ditinggalkan mendukungnya. Impor dalam jumlah besar akan lambat saat refresh pertama karena setiap feed diambil satu kali. Jadi, tunggu cron berjalan pertama kali sebelum menilai kecepatannya.

Baca di ponsel

FreshRSS mendukung Google Reader API, yang didukung oleh banyak aplikasi RSS. Dua hal harus terpenuhi. Pada pengaturan autentikasi, "Allow API access" harus aktif. Flag --api-enabled di atas sudah mengaktifkannya. Pada profil Anda, kolom kata sandi API harus berisi nilai. Kata sandi ini sengaja dipisahkan dari kata sandi login karena ponsel lebih mudah hilang.

Buka https://rss.example.com/api/ untuk menjalankan pemeriksaan konfigurasi server secara otomatis. Konfigurasi yang berfungsi akan menampilkan PASS. Jika pemeriksaan gagal, periksa pengaturan AllowEncodedSlashes On pada virtual host dan error yang dilaporkan. Di aplikasi, masukkan alamat server sebagai https://rss.example.com/api/greader.php, username sebagai pengguna FreshRSS Anda, dan kata sandi API sebagai password.

Alternatif Docker

Jika Anda tidak ingin memelihara PHP dan Apache secara manual, proyek ini menyediakan image freshrss/freshrss resmi, dan satu file compose menyediakan aplikasi beserta database-nya. Konsekuensinya sama seperti biasa: lebih sedikit komponen yang perlu dikelola pada host, tetapi ada satu lapisan tambahan yang harus di-debug saat terjadi masalah. Reverse proxy tetap diperlukan untuk TLS (transport layer security). Jika pendekatan ini lebih sesuai bagi Anda, dasar-dasar Docker Compose untuk VPS menjelaskan format file tersebut, dan baris cron-nya menjadi docker exec --user www-data freshrss php ./app/actualize_script.php.

Pencadangan dan pemutakhiran

Dua hal menyimpan state Anda: database dan /srv/freshrss/data/. Buat dump database dengan sudo mysqldump freshrss > freshrss.sql, salin /srv/freshrss/data/, lalu simpan keduanya di lokasi selain server ini. Daftar langganan Anda juga sebaiknya sesekali diekspor dalam format OPML, karena file tersebut dapat memindahkan daftar feed ke reader lain yang mendukung OPML. File itu tidak menyimpan pengaturan khusus FreshRSS, seperti frekuensi refresh, kredensial, user agent, atau aturan web scraping XPath; gunakan ekspor SQLite untuk mempertahankan pengaturan tersebut.

Pemutakhiran dilakukan dengan mengekstrak release yang lebih baru ke direktori yang sama, lalu menjalankan kembali perintah untuk mengatur ownership. Ikuti jalur pemutakhiran proyek dari satu versi ke versi berikutnya, dan verifikasi FreshRSS setelah setiap langkah. FreshRSS menerapkan migrasi databasenya sendiri saat halaman berikutnya dimuat. Lakukan pencadangan terlebih dahulu, karena migrasi yang gagal pada database yang tidak dapat dipulihkan akan menempatkan Anda pada kondisi yang tidak dapat dipulihkan. Jika Anda memasang FreshRSS dari tarball lama seperti 1.29.1, lanjutkan ke 1.30.4: security release 1.30.x mencakup rotasi session ID saat terjadi perubahan autentikasi dan pembatasan pada impor ZIP, sedangkan 1.30.4 juga memperbarui alternative Alpine Docker images untuk mengatasi kerentanan PHP serius. Reader merupakan service berisiko rendah untuk dijalankan dan kandidat awal yang baik jika Anda sedang meninjau daftar hal yang layak di-self-host.

FAQ

Mengapa feed saya hanya diperbarui saat saya membuka FreshRSS?

Membuka halaman tidak menjadwalkan pengambilan feed. Tanpa scheduler, gunakan tautan pembaruan untuk melakukan refresh secara manual. Tambahkan baris cron yang memanggil app/actualize_script.php sebagai pengguna www-data, lalu jalankan skrip tersebut secara manual sekali dan baca outputnya. Jika tidak ada output, periksa output error PHP dan log FreshRSS, lalu pastikan pengguna cron memiliki akses tulis ke data/.

Mengapa aplikasi seluler saya tidak dapat terhubung, tetapi situs web berfungsi?

Google Reader API menempatkan slash yang dienkode (%2F) di dalam path permintaan, dan Apache menolaknya secara default. Tambahkan AllowEncodedSlashes On di dalam virtual host, lalu reload Apache. Konfirmasikan perbaikannya dengan membuka https://rss.example.com/api/. Pemeriksaan konfigurasi otomatis seharusnya melaporkan PASS. Periksa juga apakah kata sandi API telah ditetapkan di profil Anda, karena kata sandi tersebut terpisah dari kata sandi login Anda.

Sebaiknya saya menggunakan SQLite atau MariaDB?

SQLite memerlukan ekstensi php-sqlite3, tetapi tidak memerlukan database server atau kata sandi database yang harus dikelola. Setiap pengguna memperoleh file database SQLite terpisah, sehingga penambahan pengguna kedua tidak menyebabkan konflik pada satu file bersama atau memerlukan MariaDB. Gunakan MariaDB jika Anda ingin menggunakan database server dalam stack LAMP Anda. Perpindahan di antara keduanya dapat dilakukan nanti melalui perintah ekspor dan impor, jadi ini bukan keputusan permanen.

Installer gagal saat menulis konfigurasinya. Apa masalahnya?

PHP berjalan sebagai www-data di bawah Apache, dan pengguna tersebut tidak dapat menulis ke direktori yang dimiliki oleh root. Jalankan kembali sudo chown -R www-data:www-data /srv/freshrss dan sudo chmod -R g+w /srv/freshrss/data, lalu mulai installer lagi. Jika Anda sudah menjalankan installer baris perintah sebagai root, perbaiki kepemilikan file yang dibuatnya di bawah data/ sebelum mencoba lagi.

Berapa banyak sumber daya server yang diperlukan pembaca RSS yang di-host sendiri?

Sangat sedikit. FreshRSS dirancang untuk berjalan pada perangkat keras dengan sumber daya terbatas, tetapi penggunaan sumber daya bergantung pada feed, ukuran artikel, dan pengaturan retensi Anda. Penggunaan disk bertambah seiring retensi, jadi tetapkan kebijakan penghapusan artikel pada pengaturan pengarsipan daripada menyimpan semuanya selamanya.

Apakah artikel ini bermanfaat?