Mengatasi FileBrowser Quantum yang Tidak Bisa Dibuka di CasaOS (Armbian, HG680P)

Beberapa waktu lalu saya mencoba instal FileBrowser Quantum — fork modern dari FileBrowser klasik — di CasaOS yang berjalan di atas Armbian, di STB Android bekas tipe HG680P. Setelah proses instalasi via app store BigBearCasaOS selesai, aplikasinya muncul di dashboard, tapi begitu diklik… tidak bisa dibuka sama sekali.

Tulisan ini merangkum proses debugging-nya, siapa tahu ada yang mengalami masalah serupa.

Gejala

Container terinstal, statusnya terlihat “berjalan” di CasaOS, tapi halaman web-nya tidak pernah muncul di browser. Tidak ada pesan error yang jelas dari UI CasaOS sendiri — jadi langkah pertama adalah masuk lewat SSH dan cek langsung ke Docker-nya.

Langkah 1: Cek Arsitektur Sistem

Karena perangkatnya STB Android yang di-Armbian-kan, hal pertama yang saya curigai adalah ketidakcocokan arsitektur image Docker. FileBrowser Quantum mendukung linux/amd64, linux/arm64, dan linux/arm/v7 — tapi khusus varian arm/v7, hanya tersedia di image tag -slim.

Banyak build Armbian legacy-kernel untuk SoC Amlogic (S905/S905X, termasuk HG680P) sebenarnya berjalan dalam mode 32-bit meski chip-nya 64-bit capable. Kalau begitu, dan image yang ditarik bukan varian slim, container bisa gagal jalan total (exec format error).

Cek dengan:

uname -m

Kalau hasilnya armv7l, pastikan pakai image tag -slim. Di kasus saya, hasilnya aarch64 (64-bit murni), jadi masalahnya bukan di sini — lanjut ke langkah berikutnya.

Langkah 2: Cek Log Container

Ini langkah paling penting dan sering dilewatkan. CasaOS tidak selalu menampilkan error internal container di UI-nya, jadi harus dicek manual:

docker ps -a | grep filebrowser
docker logs <nama_container> --tail 50

Dari sini muncul error yang jelas:

[FATAL] config file /home/filebrowser/data/config.yaml does not exist,
please create it or set the FILEBROWSER_CONFIG environment variable
to a valid config file path

Container-nya restart terus-menerus (crash loop) karena file konfigurasi yang dibutuhkan tidak ada.

Penyebab: Volume Ter-mount, tapi File Konfigurasi Tidak Dibuat

Ternyata ini bug yang cukup dikenal pada paket instalasi FileBrowser Quantum di BigBearCasaOS: folder data sudah di-mount dengan benar ke container, tapi file config.yaml di dalamnya tidak otomatis dibuat saat instalasi. Beda dengan sebagian aplikasi self-hosted lain yang bikin config default sendiri saat pertama kali jalan, FileBrowser Quantum versi ini mewajibkan file config sudah ada di lokasi yang ditentukan sebelum container bisa start.

Untuk konfirmasi lokasi mount folder-nya, saya cek dengan:

docker inspect <nama_container> -f '{{range .Mounts}}{{.Source}} -> {{.Destination}}{{"\n"}}{{end}}'

Hasilnya menunjukkan dua mount penting:

/DATA/AppData/big-bear-filebrowser-quantum/data -> /home/filebrowser/data
/DATA/AppData/big-bear-filebrowser-quantum/srv  -> /srv

Folder srv di host itulah yang jadi sumber file yang nantinya bisa dijelajahi lewat web UI, sedangkan data adalah tempat config, database, dan cache disimpan.

Solusi: Buat config.yaml Secara Manual

Saya buat file config minimal langsung di folder host yang di-mount ke /home/filebrowser/data:

cat > /DATA/AppData/big-bear-filebrowser-quantum/data/config.yaml << 'EOF'
server:
  sources:
    - path: "/srv"
      name: "Files"
auth:
  adminUsername: admin
  adminPassword: "passwordkuat"
EOF

Lalu restart container:

docker restart <nama_container>

Jebakan Kedua: Typo YAML yang Bikin Bingung

Setelah restart, error [FATAL] config file ... does not exist memang hilang, tapi muncul error baru:

[FATAL] error parsing YAML data: [7:3] non-map value is specified
   6 |   adminUsername: admin
>  7 |   adminPassword:"passwordsaya"

Penyebabnya sepele tapi gampang terlewat: tidak ada spasi setelah tanda titik dua pada baris adminPassword:"passwordsaya". YAML itu strict soal ini — tanpa spasi setelah :, parser membaca baris itu sebagai key tanpa value yang valid, bukan pasangan key-value.

Perbaikannya cukup menambahkan satu spasi:

adminPassword: "passwordsaya"

Setelah diperbaiki dan container di-restart ulang, FileBrowser Quantum akhirnya bisa diakses normal lewat browser.

Ringkasan Langkah Debugging

Kalau ada aplikasi Docker di CasaOS yang “terinstal tapi tidak bisa dibuka”, urutan pengecekan yang saya pakai:

1. Cek arsitektur sistem (uname -m) — pastikan image Docker yang dipakai memang mendukung arsitektur perangkat.
2. Cek status dan log container (docker ps -a, docker logs <container> --tail 50) — jangan hanya mengandalkan tampilan CasaOS, karena error sebenarnya sering hanya muncul di log Docker.
3. Cek volume mount (docker inspect <container>) — pastikan file/folder yang dibutuhkan aplikasi benar-benar ada di path yang di-mount, bukan cuma foldernya saja.
4. Perhatikan detail sintaks kalau errornya soal parsing config — YAML sensitif terhadap indentasi dan spasi.

Semoga catatan ini membantu kalau ada yang mengalami masalah serupa saat coba-coba self-hosting di perangkat STB Android bekas seperti HG680P.