FileBrowser Quantum: Panduan Lengkap File Manager Self-Hosted Gratis untuk Homelab

Kalau kamu sedang mencari file manager berbasis web yang ringan, gratis, dan bisa dijalankan sendiri di server rumah (homelab), NAS, atau bahkan STB Android bekas, kemungkinan besar nama FileBrowser Quantum sudah muncul di radar pencarianmu. Dalam tulisan ini saya bahas tuntas apa itu FileBrowser Quantum, fitur-fiturnya, perbandingannya dengan alternatif lain seperti Nextcloud, sampai catatan langsung dari pengalaman saya menginstalnya sendiri di perangkat rumahan.

Apa Itu FileBrowser Quantum?

FileBrowser Quantum adalah fork dari proyek FileBrowser klasik, dikembangkan oleh Graham Steffaniak (gtsteffaniak) di GitHub. Berbeda dari proyek aslinya yang perkembangannya melambat, FileBrowser Quantum dibangun ulang cukup signifikan dengan tujuan menjadi file manager self-hosted terbaik yang tetap gratis dan open-source, dirilis di bawah lisensi Apache-2.0.

Secara sederhana, aplikasi ini memberi kamu antarmuka web mirip Google Drive atau Dropbox, tapi datanya sepenuhnya ada di server milikmu sendiri, bukan di cloud milik pihak ketiga.

Kenapa Disebut Quantum?

Nama Quantum dipakai karena proyek ini memadatkan banyak fitur canggih ke dalam satu binary yang kecil dan mudah dijalankan. Dibanding kebanyakan alternatif file manager self-hosted lain yang butuh setup rumit dengan banyak dependency, FileBrowser Quantum didesain untuk tetap sederhana dipasang dan dikonfigurasi, sekalipun fiturnya jauh lebih lengkap dari versi originalnya.

Fitur Utama FileBrowser Quantum

1. Multi-Source dan Aturan Akses Fleksibel

Kamu bisa menghubungkan lebih dari satu folder/sumber data sekaligus, lengkap dengan aturan include/exclude per sumber, cocok kalau kamu punya beberapa disk atau folder terpisah yang ingin diakses lewat satu dashboard.

2. Dukungan Login Modern

Selain login dengan username/password biasa (dengan opsi 2FA), FileBrowser Quantum juga mendukung OIDC, LDAP, JWT, dan mode proxy auth, jadi bisa diintegrasikan dengan sistem identity provider yang sudah kamu punya, misalnya Authentik atau Authelia.

3. Pencarian Real-Time

Pencarian file dan folder terjadi secara real-time saat kamu mengetik, lengkap dengan filter berdasarkan ukuran file dan tipe. Fitur ini sering disebut sebagai salah satu keunggulan utamanya dibanding kompetitor.

4. Preview dan Thumbnail yang Lebih Kaya

Mendukung thumbnail untuk file kantor (dokumen, spreadsheet), video, cover album musik, hingga model 3D, bukan cuma gambar biasa seperti kebanyakan file manager sederhana lainnya.

5. Sharing yang Bisa Dikustomisasi

Kamu bisa membuat link berbagi file dengan berbagai opsi keamanan, dan bahkan menyematkan (pin) file tertentu di dalam share.

6. API dan Token Jangka Panjang

Tersedia dukungan API token untuk automasi, lengkap dengan halaman dokumentasi Swagger bawaan di endpoint /swagger.

FileBrowser Quantum vs Nextcloud vs Alternatif Lain

Pertanyaan yang sering muncul: kenapa pilih FileBrowser Quantum, bukan Nextcloud yang sudah lebih populer? Jawabannya tergantung kebutuhan.

Aspek	FileBrowser Quantum	Nextcloud
Fokus utama	File manager web sederhana	Suite kolaborasi lengkap (file, kalender, kontak, office)
Kemudahan setup	Sangat mudah, satu binary/container	Lebih kompleks, banyak dependency
Sinkronisasi client (desktop/mobile app sync)	Tidak ada secara native	Ada, lengkap dengan app resmi
Kebutuhan resource	Ringan, cocok untuk perangkat kecil	Lebih berat
Cocok untuk	Homelab kecil, NAS pribadi, akses file cepat	Kebutuhan kolaborasi tim, pengganti Google Workspace

Kalau prioritasmu adalah akses file cepat lewat browser tanpa perlu fitur sinkronisasi otomatis ala Dropbox, FileBrowser Quantum jelas lebih ringan dan cepat disiapkan. Tapi kalau kamu butuh sinkronisasi multi-perangkat, kalender, atau kolaborasi dokumen real-time, Nextcloud (atau kombinasi keduanya) masih lebih relevan.

Selain Nextcloud, ada juga alternatif sekelas seperti Filestash (kuat di multi-protokol: FTP, SFTP, WebDAV, S3), Seafile, dan copyparty, masing-masing punya trade-off sendiri antara kesederhanaan dan kelengkapan fitur.

Kapan FileBrowser Quantum Cocok dan Kapan Tidak

Supaya ekspektasimu realistis, ini catatan jujur dari sisi kekurangan yang perlu kamu tahu:

Cocok kalau:

Kamu punya server rumahan/NAS/STB bekas dan cuma butuh akses file lewat browser.
Kamu ingin kontrol penuh atas data tanpa bergantung ke cloud pihak ketiga.
Kamu sudah familiar (atau siap belajar) dasar Docker dan YAML.

Perlu dipikirkan kalau:

Kamu butuh sinkronisasi otomatis antar perangkat seperti Dropbox/Google Drive, ini bukan fitur bawaan FileBrowser Quantum.
Kamu masih pemula banget di Docker/Linux, karena troubleshooting-nya (seperti yang saya alami sendiri, lihat bagian bawah) kadang butuh baca log container secara manual.
Proyek ini masih aktif dikembangkan dengan cukup banyak rilis versi beta, artinya ada kemungkinan perubahan konfigurasi antar versi yang perlu diperhatikan sebelum upgrade.

Cara Instal FileBrowser Quantum

Cara paling umum adalah lewat Docker. Contoh docker-compose.yml dasar:

services:
  filebrowser:
    image: gtstef/filebrowser:latest
    container_name: filebrowser-quantum
    ports:
      - "8080:80"
    volumes:
      - './data:/home/filebrowser/data'
      - '/path/ke/folder/kamu:/srv'
    restart: unless-stopped

Poin penting yang sering terlewat: FileBrowser Quantum mewajibkan file config.yaml sudah tersedia di folder yang di-mount ke /home/filebrowser/data sebelum container bisa berjalan. Contoh isi minimal:

server:
  sources:
    - path: "/srv"
      name: "Files"
auth:
  adminUsername: admin
  adminPassword: "password-yang-kuat"

Kalau kamu pakai platform manajemen container seperti CasaOS, prosesnya bisa lebih mudah lewat app store, tapi tetap perlu memperhatikan poin config di atas, karena beberapa paket instalasi komunitas belum otomatis membuatkan file ini.

Pengalaman Pribadi: Instal di STB Android HG680P dengan Armbian + CasaOS

Sebagai bagian dari eksperimen homelab murah, saya mencoba instal FileBrowser Quantum di STB Android bekas tipe HG680P yang sudah saya-flash dengan Armbian, lalu dijalankan lewat CasaOS. Setelah instalasi lewat app store komunitas (BigBearCasaOS), aplikasinya muncul di dashboard tapi tidak bisa dibuka sama sekali.

Setelah ditelusuri lewat docker logs, ternyata penyebabnya persis seperti yang saya sebutkan di atas: file config.yaml belum otomatis dibuat oleh paket instalasinya, jadi container terus crash-loop. Setelah saya buat file config secara manual dan restart container, aplikasinya langsung bisa diakses normal.

Saya tulis proses debugging lengkapnya, termasuk satu jebakan tambahan berupa typo sintaks YAML yang sempat bikin bingung, di artikel terpisah: Mengatasi FileBrowser Quantum yang Tidak Bisa Dibuka di CasaOS.

Tips Praktis Agar Instalasi Lancar

Berdasarkan pengalaman langsung di atas, berikut checklist yang saya sarankan sebelum dan sesudah instalasi:

Cek arsitektur perangkat dengan uname -m sebelum menarik image Docker, pastikan image yang dipakai mendukung arsitektur perangkatmu (khususnya di perangkat ARM 32-bit, wajib pakai image tag -slim).
Selalu cek docker logs kalau aplikasi “terpasang tapi tidak bisa dibuka” — dashboard CasaOS atau platform sejenis tidak selalu menampilkan error sebenarnya.
Pastikan config.yaml sudah ada di folder data sebelum container pertama kali dijalankan.
Teliti soal spasi di YAML — tanpa spasi setelah tanda titik dua (:), parser YAML akan gagal membaca file konfigurasimu.

FAQ Seputar FileBrowser Quantum

Apakah FileBrowser Quantum gratis? Ya, sepenuhnya gratis dan open-source di bawah lisensi Apache-2.0, dan menurut pernyataan pengembangnya akan tetap begitu.

Apakah FileBrowser Quantum bisa jalan di Raspberry Pi atau STB Android? Bisa, selama perangkat menjalankan Docker dan arsitekturnya didukung (amd64, arm64, atau arm/v7 lewat image slim).

Apa bedanya FileBrowser Quantum dengan FileBrowser biasa (original)? FileBrowser Quantum adalah fork besar-besaran dari proyek original dengan banyak fitur tambahan: login OIDC/LDAP/JWT, multi-source, pencarian real-time, dan konfigurasi berbasis config.yaml yang lebih terstruktur.

Apakah FileBrowser Quantum cocok menggantikan Nextcloud sepenuhnya? Tergantung kebutuhan. Untuk sekadar akses dan kelola file lewat browser, ya. Tapi kalau kamu butuh sinkronisasi otomatis, kalender, atau kolaborasi dokumen, Nextcloud masih lebih lengkap.

FileBrowser Quantum adalah pilihan solid untuk siapa pun yang ingin file manager self-hosted yang ringan, cepat, dan gratis — terutama untuk homelab skala kecil atau perangkat hemat daya seperti STB Android bekas. Yang perlu diingat, sebagai proyek yang masih aktif berkembang, kamu perlu sedikit lebih teliti soal konfigurasi dibanding aplikasi yang sudah lebih matang. Tapi dengan pemahaman dasar Docker dan sedikit kesabaran membaca log, aplikasi ini bisa jadi andalan homelab-mu.