Daftar Isi
CasaOS adalah sistem operasi berbasis Docker yang memudahkan pengguna dalam mengelola aplikasi self-hosted. Namun, kapasitas penyimpanan internal seringkali terbatas. Solusinya? Mount storage external (HDD, SSD, atau USB flashdisk) agar bisa digunakan oleh aplikasi Docker di CasaOS.
Artikel ini akan membahas cara mounting storage external di CasaOS dengan format FAT32, NTFS, dan ext4, serta mengatur permission agar aplikasi Docker bisa mengaksesnya.
Persiapan Sebelum Mounting
- Sambungkan storage external (USB/HDD) ke perangkat CasaOS.
- Cek device storage dengan perintah:
sudo fdisk -l
Contoh output:
/dev/sda1 (biasanya storage internal) /dev/sdb1 (biasanya storage external)
- Format storage (opsional) jika belum terformat:
- FAT32 (untuk kompatibilitas tinggi):
sudo mkfs.vfat /dev/sdb1 -n USB32GB
- NTFS (untuk file besar >4GB):
sudo mkfs.ntfs /dev/sdb1 -f
- ext4 (rekomendasi untuk Linux):
sudo mkfs.ext4 /dev/sdb1
- FAT32 (untuk kompatibilitas tinggi):
Cara Mount Storage di CasaOS
1. Buat Mount Point
sudo mkdir -p /mnt/external
2. Mount Manual (Testing)
Untuk FAT32
sudo mount -t vfat /dev/sdb1 /mnt/external -o uid=1000,gid=1000,umask=000
Untuk NTFS
sudo mount -t ntfs-3g /dev/sdb1 /mnt/external -o uid=1000,gid=1000
Untuk ext4
sudo mount /dev/sdb1 /mnt/external
sudo chown -R 1000:1000 /mnt/external # Berikan akses ke user CasaOS
3. Mount Permanen (Tambahkan ke /etc/fstab)
Edit file /etc/fstab:
sudo nano /etc/fstab
Tambahkan baris berikut sesuai format:
FAT32
/dev/sdb1 /mnt/external vfat uid=1000,gid=1000,umask=000 0 0
NTFS
/dev/sdb1 /mnt/external ntfs-3g uid=1000,gid=1000 0 0
ext4
/dev/sdb1 /mnt/external ext4 defaults 0 0
Kemudian remount:
sudo mount -a
4. Berikan Permission untuk CasaOS & Docker
Pastikan CasaOS (yang biasanya berjalan sebagai root atau user 1000) bisa mengakses:
sudo chmod -R 777 /mnt/external # Full access (hati-hati di production!)
Cara Menggunakan Storage di Aplikasi Docker
1. Tambahkan Storage ke CasaOS GUI
- Buka CasaOS Dashboard → Settings → Storage.
- Klik "Add Storage" dan pilih /mnt/external.
2. Konfigurasi Volume di Docker
Saat install aplikasi via CasaOS:
- Di bagian "Storage", tambahkan:
- Host Path: /mnt/external
- Container Path: /data (sesuaikan dengan kebutuhan)
Atau edit docker-compose.yml secara manual:
volumes:
- /mnt/external:/data
Troubleshooting
1. Error "Permission Denied" di Docker?
Pastikan storage sudah di-mount dengan opsi uid=1000 (user CasaOS).
Jika masih gagal, coba:
sudo chmod -R 777 /mnt/external
2. Storage Tidak Muncul di CasaOS?
Cek apakah sudah benar di-mount:
df -h
Restart CasaOS:
sudo systemctl restart casaos
3. Mau Format Ulang ke ext4?
Jika FAT32/NTFS bermasalah, format ke ext4:
sudo umount /dev/sdb1
sudo mkfs.ext4 /dev/sdb1
sudo mount /dev/sdb1 /mnt/external
Kesimpulan
Dengan mounting storage external di CasaOS, Anda bisa:
- ✅ Menambah kapasitas penyimpanan untuk aplikasi Docker.
- ✅ Menggunakan HDD/USB sebagai media penyimpanan tambahan.
- ✅ Mengatur permission sesuai kebutuhan keamanan.
Tips:
- Untuk performa terbaik, gunakan ext4 (khusus Linux).
- Jika butuh kompatibilitas Windows, pakai NTFS.
- Hindari chmod 777 di sistem produksi (risiko keamanan).
Semoga berhasil! 🚀