Navidrome adalah server musik sumber terbuka yang memungkinkan pengguna mengalirkan koleksi audio pribadi ke peramban maupun perangkat seluler dari mana saja seperti Spotify pribadi. Panduan ini menguraikan langkah demi langkah pemasangan Navidrome secara aman menggunakan Podman di Fedora Linux, baik pada server PC x86 standar maupun perangkat Raspberry Pi berbasis ARM berdaya rendah.

[nico@stamfordbridge navidrome\]$ podman pull deluan/navidrome
✔ docker.io/deluan/navidrome:latest
Trying to pull docker.io/deluan/navidrome:latest…
Getting image source signatures
Copying blob 75c0824146ea done |
Copying blob 4f4fb700ef54 done |
Copying blob 4f4fb700ef54 done |
Copying blob e1dbf20ea67c done |
Copying blob 1cc3d825d8b2 done |
Copying config 0c9bad3bd7 done |
Writing manifest to image destination
0c9bad3bd7305815d56fe588a64f9172a8bb6aa2bfef3ad77e764c8694e7e860

Dukungan Multi-Arsitektur Citra Kontainer

Ketersediaan citra kontainer resmi Navidrome mencakup berbagai arsitektur perangkat keras, yaitu linux/amd64, linux/arm64, linux/arm/v6, dan linux/arm/v7. Format multi-arsitektur tersebut menjadikan proses pemasangan aplikasi ini sangat portabel untuk berbagai jenis mesin komputasi. Citra kontainer resmi yang disediakan untuk platform-platform tersebut telah memuat segala kebutuhan yang diperlukan secara menyeluruh untuk menjalankan server musik Navidrome.

Konfigurasi Keamanan SELinux

Apabila fitur keamanan SELinux berada dalam kondisi aktif pada server Fedora Linux yang Anda gunakan, penambahan konteks SELinux container_file_t wajib dilakukan terhadap direktori Data dan direktori Music beserta seluruh isi berkas yang berada di dalamnya. Langkah ini memastikan bahwa sistem keamanan Fedora mengenali direktori-direktori penyimpanan tersebut sebagai berkas yang diizinkan untuk diakses oleh kontainer.

[nico@stamfordbridge navidrome]$ sudo semanage fcontext -a -t container_file_t  '/home/nico/navidrome/Data(/.\*)?'

[nico@stamfordbridge navidrome]$ sudo semanage fcontext -a -t container_file_t  '/home/nico/navidrome/Music(/.\*)?'

Setelah pendaftaran konteks keamanan selesai dilakukan, langkah berikutnya adalah memberlakukan kebijakan SELinux secara langsung ke direktori Data dan Music. Tindakan ini bertindak menerapkan aturan keamanan yang baru saja ditetapkan sehingga izin pada struktur folder lokal langsung diperbarui secara efektif sebelum kontainer dijalankan.

[nico@stamfordbridge navidrome]$  sudo restorecon -R /home/nico/navidrome/Data

[nico@stamfordbridge navidrome]$  sudo restorecon -R /home/nico/navidrome/Music

Penyesuaian Hak Akses Direktori

Pengelolaan hak kepemilikan direktori lokal juga harus disesuaikan secara tepat sebelum menjalankan aplikasi. Anda perlu mengganti pemilik dari direktori /home/nico/navidrome/Data dan direktori /home/nico/navidrome/Music menjadi ID 1000. Penyesuaian kepemilikan tersebut dilakukan agar kepemilikan berkas lokal selaras dengan identitas pengguna yang beroperasi di dalam wadah kontainer.

[nico@stamfordbridge navidrome]$ podman unshare chown 1000:1000 /home/nico/navidrome/Data

[nico@stamfordbridge navidrome]$ podman unshare chown 1000:1000 /home/nico/navidrome/Music

Konfigurasi dan Menjalankan Podman Compose

Tahap konfigurasi selanjutnya melibatkan pembuatan berkas podman-compose.yml yang berisi detail spesifikasi layanan Navidrome, atau Anda dapat menyisipkan definisi service navidrome ke dalam berkas komposisi yang sebelumnya sudah tersedia pada sistem Anda. Berkas ini bertugas mendefinisikan seluruh parameter operasional yang dibutuhkan, mulai dari pemilihan citra kontainer, penetapan pengguna, pemetaan port, kebijakan pengaktifan ulang, variabel lingkungan, hingga penentuan volume direktori.

[nico@stamfordbridge navidrome]$ cat podman-compose.yml
version: "3"
services:
  navidrome:
    image: deluan/navidrome:latest
    user: 1000:1000 # should be owner of volumes
    ports:
      - "4533:4533"
    restart: unless-stopped
    environment:
      # Optional: put your config options customization here. Examples:
      ND_SCANSCHEDULE: 1h
      ND_LOGLEVEL: info  
      ND_SESSIONTIMEOUT: 24h
      ND_BASEURL: ""
    volumes:
      - "/home/nico/navidrome/Data:/data"
      - "/home/nico/navidrome/Music:/music:ro"

Setelah berkas konfigurasi tersusun dengan lengkap, jalankan kontainer navidrome menggunakan perintah podman-compose up -d. Perintah tersebut akan menginstruksikan Podman untuk membaca berkas komposisi dan segera mengaktifkan kontainer di latar belakang sistem Fedora Linux Anda.

[nico@stamfordbridge navidrome]$ podman-compose up -d

Penetapan Variabel Lingkungan dan Volume

Perlu diperhatikan bahwa variabel lingkungan yang tercantum pada contoh konfigurasi di atas hanyalah sebuah contoh dan tidak bersifat wajib untuk disertakan karena nilai-nilai dalam contoh tersebut sebenarnya sudah merupakan nilai bawaan dari Navidrome. Terkait argumen user, nilainya secara ideal harus mencerminkan UID:GID dari pemilik pustaka musik lokal demi menghindari timbulnya masalah izin berkas. Walaupun direktif user ini dapat diabaikan ketika Anda melakukan pengujian, aturan praktis yang berlaku menegaskan bahwa Anda tidak boleh menjalankan kontainer pada lingkungan produksi sebagai root.

[nico@stamfordbridge navidrome]$ podman run -d - name navidrome - restart=unless-stopped - user $(id -u):$(id -g) -v /home/ec2-user/navidrome/Music:/music -v /home/ec2-user/navidrome/Data:/data -p 4533:4533 -e ND_LOGLEVEL=info deluan/navidrome:latest
c00c31d49ec5e0f0a0141aef9e2b69abf6a1b5f0604515bc7111f3e0ef398237

[nico@stamfordbridge navidrome]$ podman ps -a
CONTAINER ID IMAGE COMMAND CREATED STATUS PORTS NAMES
c00c31d49ec5 docker.io/deluan/navidrome:latest 9 seconds ago Up 9 seconds 0.0.0.0:4533->4533/tcp navidrome

Pastikan Anda selalu mengingat untuk mengubah jalur volume agar mengarah ke direktori lokal pada sistem Anda sendiri. Di dalam struktur direktori Navidrome, jalur /data merupakan tempat di mana aplikasi menyimpan basis data serta berkas cache miliknya, sedangkan jalur /music merupakan lokasi tempat berkas musik Anda disimpan. Opsi konfigurasi server dapat disesuaikan menggunakan variabel lingkungan sesuai keperluan; pada podman-compose Anda cukup menyematkannya ke bagian environment dalam berkas yml, sementara pada Podman CLI Anda dapat menggunakan parameter -e seperti contohnya -e ND_SESSIONTIMEOUT=24h. Di samping itu, jika Anda ingin menggunakan berkas konfigurasi saat menjalankan Navidrome di Podman, Anda dapat membuat berkas konfigurasi navidrome.toml di dalam folder /data dan mengatur opsi ND_CONFIGFILE=/data/navidrome.toml.

Terjemahan dan adaptasi Bahasa Indonesia menggunakan AI oleh Zennovan News. Sumber bahan asli: Installing Navidrome on Fedora Linux using Podman. By Nico Shetty from Fedora Magazine. Terjemahan/adaptasi prosa ini tersedia dengan CC BY-SA 4.0; lisensi foto terpisah. Ketentuan sumber. Adaptasi ini tidak menyiratkan dukungan penerbit asli.