Berikut adalah draf Buku Panduan Lengkap untuk menginstal, mengonfigurasi, dan mengoperasikan CasaOS di lingkungan Proxmox VE. Anda dapat menyimpan ini sebagai dokumen referensi, wiki, atau e-book pribadi.
📖 BUKU PANDUAN: MENGOPERASIKAN CASAOS DI PROXMOX VE
Panduan Praktis Membangun Home Server Visual dengan Proxmox & CasaOS
📑 DAFTAR ISI
1. Bab 1: Pengenalan Proxmox dan CasaOS
2. Bab 2: Persiapan dan Download Template
3. Bab 3: Instalasi CasaOS di Proxmox (LXC Container)
4. Bab 4: Konfigurasi Awal dan Akses Web UI
5. Bab 5: Manajemen Aplikasi dan Docker
6. Bab 6: Manajemen Penyimpanan (Pass-through Storage)
7. Bab 7: Backup, Update, dan Pemeliharaan
8. Bab 8: Troubleshooting (Pemecahan Masalah)
📖 BAB 1: PENGENALAN PROXMOX DAN CASAOS
Apa itu Proxmox VE?
Proxmox Virtual Environment (VE) adalah platform virtualisasi open-source berbasis Debian yang mengelola Virtual Machine (VM) dan Linux Container (LXC). Proxmox adalah "rumah" atau hypervisor untuk server Anda.
Apa itu CasaOS?
CasaOS adalah sistem operasi berbasis web yang sangat ringan dan visual, dirancang khusus untuk home server. Di bawah kapnya, CasaOS sebenarnya adalah antarmuka grafis (GUI) yang sangat rapi untuk mengelola Docker dan Docker Compose.
Mengapa Menggabungkan Keduanya?
Efisiensi: Menggunakan LXC di Proxmox jauh lebih ringan daripada VM penuh.
Kemudahan: CasaOS menghilangkan kerumitan baris perintah Docker, menyediakan "App Store" untuk instalasi aplikasi (Plex, Home Assistant, Pi-hole, dll) dalam satu klik.
Isolasi: Jika CasaOS rusak, Anda bisa menghapus containernya dan membuatnya ulang dalam 5 menit tanpa merusak sistem Proxmox utama.
📖 BAB 2: PERSIAPAN DAN DOWNLOAD TEMPLATE
Sebelum membuat container, kita perlu mengunduh template sistem operasi. CasaOS secara resmi mendukung Ubuntu dan Debian. Kita akan menggunakan Debian 12 (atau Ubuntu 22.04/24.04) karena sangat stabil dan ringan.
1. Login ke Web UI Proxmox.
2. Pilih node server Anda di panel kiri, lalu klik local (pve) -> CT Templates.
3. Klik tombol Templates di bagian atas.
4. Cari dan download template berikut:
`debian-12-standard` (atau `ubuntu-22.04-standard`)
5. Tunggu hingga proses download selesai.
📖 BAB 3: INSTALASI CASAOS DI PROXMOX (LXC)
Ini adalah langkah paling krusial. Karena CasaOS menggunakan Docker di dalamnya, kita harus mengaktifkan fitur nesting pada LXC.
1. Membuat Container (CT)
1. Klik Create CT di pojok kanan atas.
2. Hostname: Isi dengan nama, misal: `casaos`.
3. Password: Buat password root untuk container ini.
4. Template: Pilih template Debian/Ubuntu yang sudah didownload.
5. Disks: Beri ukuran minimal 16GB (32GB lebih disarankan).
6. CPU: Beri 2 Core (atau lebih sesuai kebutuhan).
7. Memory: Minimal 2048 MB (2GB).
8. Network:
Pastikan DHCP aktif atau beri Static IP (Sangat disarankan pakai Static IP agar URL akses tidak berubah).
Pastikan Firewall tidak dicentang (kecuali Anda paham cara mengatur firewall Proxmox).
9. DNS: Gunakan DNS default atau masukkan DNS publik (misal: `1.1.1.1` atau `8.8.8.8`).
10. Klik Finish.
2. Mengaktifkan Fitur Docker (SANGAT PENTING)
Sebelum menyalakan container, kita harus mengizinkan Docker berjalan di dalamnya.
1. Pilih container `casaos` yang baru dibuat di panel kiri.
2. Masuk ke menu Options -> Features.
3. Klik Edit, lalu centang `nesting` dan `keyctl`.
4. Klik OK.
3. Instalasi CasaOS via Console
1. Klik container `casaos`, lalu pilih menu Console (atau SSH ke IP container tersebut).
2. Login dengan user `root` dan password yang Anda buat.
3. Update sistem dan install dependency:
apt update && apt upgrade -y
apt install curl sudo -y4. Jalankan script instalasi resmi CasaOS:
curl -fsSL https://get.casaos.io | sudo bash5. Tunggu proses instalasi selesai (biasanya 2-5 menit).
6. Jika selesai, akan muncul notifikasi sukses beserta URL akses (biasanya `http://<IP-Container>`).
📖 BAB 4: KONFIGURASI AWAL DAN AKSES WEB UI
1. Buka browser di komputer Anda, dan masukkan IP address dari container CasaOS (misal: `http://192.168.1.50`).
2. Anda akan disambut oleh halaman Welcome to CasaOS.
3. Buat Akun Admin: Masukkan nama pengguna, email, dan password. Ini akan digunakan untuk login ke dashboard.
4. Pilih Lokasi/Timezone: Sesuaikan dengan lokasi Anda agar log dan jadwal aplikasi akurat.
5. Setup Storage: CasaOS akan mendeteksi drive. Untuk saat ini, pilih drive utama (root) sebagai penyimpanan default.
6. Selesai! Anda sekarang berada di Dashboard CasaOS.
📖 BAB 5: MANAJEMEN APLIKASI DAN DOCKER
Dashboard CasaOS terdiri dari beberapa bagian utama:
1. CasaOS App Store
Ini adalah fitur terbaik. Di tab Apps, Anda bisa melihat ratusan aplikasi yang sudah dikonfigurasi sebelumnya.
Cara Install: Klik aplikasi (misal: Plex, Jellyfin, Home Assistant, Pi-hole), klik Install.
Konfigurasi Port: Jika ada konflik port, CasaOS akan memberi tahu Anda. Anda bisa mengubah port eksternal (misal dari 8080 ke 8081).
Klik Install dan tunggu hingga statusnya berubah menjadi Running.
2. Menambahkan Aplikasi Custom (Docker Compose)
Jika aplikasi yang Anda inginkan tidak ada di App Store, Anda bisa menambahkannya via Docker Compose.
1. Klik ikon + (atau Install a Custom App) di dashboard.
2. Pilih Docker Compose.
3. Masukkan nama aplikasi, dan paste kode `docker-compose.yml` dari GitHub/DockerHub.
4. Klik Install.
3. Mengelola Container
Di tab Settings -> Docker, Anda bisa melihat semua container yang berjalan, melihat logs, me-restart, atau menghapus aplikasi.
📖 BAB 6: MANAJEMEN PENYIMPANAN (PASS-THROUGH STORAGE)
Home server biasanya butuh penyimpanan besar (HDD/SSD tambahan) untuk media (film, musik, backup). Karena kita menggunakan LXC, kita tidak bisa langsung mencolokkan USB ke dalam container. Kita harus melakukan Mount Point atau Bind Mount.
Cara Menambahkan Folder Host Proxmox ke CasaOS (Bind Mount)
Misalnya Anda punya folder `/mnt/data/media` di Proxmox host dan ingin membukanya di CasaOS.
1. Di Proxmox Host (Shell Node Proxmox):
Buat folder tujuan di dalam container.
pct exec <ID-Container> -- mkdir -p /mnt/media(Ganti `<ID-Container>` dengan ID CT CasaOS Anda, misal `100`)
2. Edit Konfigurasi Container:
Buka file konfigurasi container di Proxmox host:
nano /etc/pve/lxc/<ID-Container>.conf3. Tambahkan Baris Berikut di Paling Bawah:
mp0: /mnt/data/media,mp=/mnt/media(Artinya: Folder `/mnt/data/media` di Proxmox di-mount ke `/mnt/media` di dalam CasaOS).
4. Save (Ctrl+O, Enter) dan Exit (Ctrl+X).
5. Restart Container CasaOS dari Proxmox UI.
6. Di CasaOS: Saat menginstal aplikasi seperti Plex atau Jellyfin, pada bagian Path/Volume, Anda sekarang bisa memilih `/mnt/media` sebagai folder penyimpanan.
📖 BAB 7: BACKUP, UPDATE, DAN PEMELIHARAAN
1. Backup via Proxmox (Sangat Disarankan)
Karena CasaOS berjalan di LXC, Anda bisa mem-backup seluruh container beserta semua aplikasi Docker-nya dalam satu kali klik.
Di Proxmox UI, pilih container CasaOS -> Backup -> Backup now.
Atur jadwal backup mingguan di menu Backup pada level node.
2. Update CasaOS
CasaOS memiliki pembaruan berkala.
Jika ada update, akan muncul notifikasi banner di bagian atas Dashboard CasaOS.
Klik Update dan ikuti petunjuknya.
3. Update Aplikasi Docker
Buka Settings -> Docker.
Pilih aplikasi yang ingin di-update, klik Update (jika ada image baru di registry).
Catatan: Selalu pastikan folder config dan data aplikasi di-mount ke storage eksternal (seperti Bab 6) agar saat container di-recreate, data Anda tidak hilang.
📖 BAB 8: TROUBLESHOOTING (PEMECAHAN MASALAH)
Masalah 1: Docker / Aplikasi gagal berjalan (Status: Exited/Error)
Penyebab: Fitur nesting belum aktif.
Solusi: Matikan CT -> Options -> Features -> Centang `nesting` dan `keyctl` -> Nyalakan kembali CT.
Masalah 2: Tidak bisa akses Web UI CasaOS (Port 80)
Penyebab: IP berubah atau ada aplikasi lain di jaringan yang menggunakan Port 80.
Solusi: Cek IP CT di Proxmox. Jika IP benar, cek apakah router/modem Anda memblokir port 80. Anda bisa mengubah port CasaOS via SSH:
casaos-cli sysmgmt set port 8080
systemctl restart casaosMasalah 3: Aplikasi (seperti Plex/Jellyfin) tidak bisa memutar video / Transcoding error
Penyebab: Container tidak memiliki akses ke hardware acceleration (GPU/iGPU).
Solusi: Anda perlu melakukan device passthrough untuk iGPU Intel/AMD ke dalam LXC. Ini memerlukan edit file `.conf` di Proxmox untuk menambahkan `dev0: /dev/dri`.
Masalah 4: Kehabisan ruang disk di CasaOS
Penyebab: Docker image dan container menumpuk.
Solusi: Buka Settings -> Docker -> Images, hapus image yang tidak terpakai (untagged/unused). Atau jalankan `docker system prune -a` via Console CT.
🎯 PENUTUP
Menggunakan CasaOS di atas Proxmox VE adalah kombinasi sempurna antara kekuatan enterprise (Proxmox) dan kemudahan konsumen (CasaOS). Anda sekarang memiliki home server yang rapi, mudah dikelola, dan sangat efisien dalam penggunaan resource.
Tips Tambahan:
Selalu gunakan Static IP untuk container CasaOS Anda.
Pertimbangkan untuk menginstal Reverse Proxy (seperti Nginx Proxy Manager atau Cloudflare Tunnels) agar Anda bisa mengakses aplikasi CasaOS dari luar rumah dengan aman menggunakan domain dan HTTPS.
Selamat bereksperimen dan menikmati Home Server Anda!
(Catatan untuk pengguna: Buku panduan ini dapat Anda salin ke Notion, Obsidian, Microsoft Word, atau diekspor menjadi PDF untuk referensi pribadi Anda.)
Berikut adalah draf Buku Panduan Khusus untuk mengatasi dan mencegah konflik port saat menginstal aplikasi di CasaOS. Panduan ini dirancang agar Anda tidak lagi pusing memikirkan "Port sudah terpakai" (*Port is already allocated*).
📖 BUKU PANDUAN: MANAJEMEN PORT & INSTALASI ANTI-TABRAKAN DI CASAOS
Panduan Praktis Mengatur Port Aplikasi Agar Berjalan Harmonis Tanpa Konflik
📑 DAFTAR ISI
1. Bab 1: Memahami Konsep Port (Host vs Container)
2. Bab 2: Cara Mengubah Port Saat Instalasi di CasaOS
3. Bab 3: Strategi Penomoran Port (Best Practices)
4. Bab 4: Solusi Tingkat Dewa: Reverse Proxy (Tanpa Pusing Urus Port)
5. Bab 5: Troubleshooting & Mencari Port yang "Hantu"
📖 BAB 1: MEMAHAMI KONSEP PORT (HOST VS CONTAINER)
Sebelum mengatur port, Anda WAJIB memahami perbedaan antara dua jenis port di Docker/CasaOS. Bayangkan IP Address adalah "Alamat Jalan", dan Port adalah "Nomor Kamar/Apartemen".
1. Port Container (Internal)
Ini adalah port yang digunakan oleh aplikasi di dalam sistem Docker.
ATURAN EMAS: JANGAN PERNAH MENGUBAH PORT INI.
Contoh: Aplikasi *Home Assistantsecara internal selalu berjalan di port `8123`. Jika Anda mengubahnya, aplikasi akan error karena tidak tahu cara berjalan.
2. Port Host (External / CasaOS)
Ini adalah port yang "dibuka" ke jaringan lokal Anda (atau ke UI CasaOS) untuk mengakses aplikasi tersebut.
Inilah port yang boleh dan harus Anda ubah jika terjadi tabrakan.
Contoh: Anda mengubah Port Host dari `8123` menjadi `8124`. Sekarang, Anda mengakses Home Assistant via browser menggunakan `http://<IP-CasaOS>:8124`, tetapi di dalam Docker, ia tetap berjalan normal di `8123`.
📖 BAB 2: CARA MENGUBAH PORT SAAT INSTALASI DI CASAOS
CasaOS memiliki antarmuka yang sangat pintar untuk mencegah konflik port. Berikut langkah-langkahnya:
Langkah-langkah Instalasi Aman:
1. Buka CasaOS App Store, pilih aplikasi yang diinginkan (misal: *Plex*).
2. Klik Install.
3. Akan muncul jendela konfigurasi. Scroll ke bawah hingga menemukan bagian Web atau Port.
4. Anda akan melihat dua kolom:
Host Port (Port Rumah): Ini yang boleh Anda ubah.
Container Port (Port Dalam): Biarkan apa adanya (default dari aplikasi).
5. Cek Konflik: Jika Anda mengetik angka di *Host Portyang sudah dipakai aplikasi lain, CasaOS akan langsung memberikan peringatan merah atau teks *"Port is already in use"*.
6. Ubah angka di *Host Portmenjadi angka yang belum terpakai (lihat Bab 3 untuk tips).
7. Klik Install.
📖 BAB 3: STRATEGI PENOMORAN PORT (BEST PRACTICES)
Agar tidak lupa dan tidak saling tabrak, buatlah "konvensi penomoran" di server Anda. Berikut adalah rekomendasi pengelompokan port:
Kategori 1: Web UI & Dashboard (8000 - 8999)
Gunakan rentang ini untuk aplikasi yang memiliki antarmuka web.
`8080` : Nginx Proxy Manager / Reverse Proxy
`8081` : Portainer (Manajemen Docker)
`8082` : File Browser / File Manager
`8083` : Nextcloud
`8123` : Home Assistant (Default, tidak perlu diubah jika belum dipakai)
`8222` : RustDesk (Remote Desktop)
`8384` : Syncthing
`8989` : Sonarr
`9091` : Transmission / qBittorrent
Kategori 2: Media Server (3000 - 3999)
`32400` : Plex Media Server (Default)
`32469` : Plex DLNA
`8096` : Jellyfin (Default)
`8920` : Jellyfin (HTTPS)
Kategori 3: Network & Ad-blocking (5000 - 5999)
`53` : Pi-hole / AdGuard Home (DNS - *Hati-hati, port 53 sering bentrok dengan systemd-resolved di Linux*)
`5353` : mDNS
💡 Tips Pro:
Catat di Notion/Excel: Buat spreadsheet sederhana berisi: *Nama Aplikasi | Port Host | Port Container | Keterangan*.
Gunakan Port yang Mudah Diingat: Jika Anda menginstal banyak web app, gunakan pola seperti `8001`, `8002`, `8003` dst.
📖 BAB 4: SOLUSI TINGKAT DEWA - REVERSE PROXY
Jika Anda menginstal 30+ aplikasi, mengatur port satu per satu (misal: `192.168.1.50:8081`, `192.168.1.50:8082`) akan sangat melelahkan.
Solusinya: Gunakan Reverse Proxy (Nginx Proxy Manager / NPM).
Dengan NPM, Anda tidak perlu lagi mengingat port. Anda cukup menggunakan nama domain lokal.
Alih-alih: `http://192.168.1.50:8123` (Home Assistant)
Anda cukup ketik: `http://homeassistant.local`
Cara Setup Singkat di CasaOS:
1. Install Nginx Proxy Manager dari CasaOS App Store.
Set Host Port ke `80` (HTTP) dan `443` (HTTPS). *Catatan: Pastikan tidak ada aplikasi lain yang memakai port 80/443 di CasaOS.*
2. Buka Web UI NPM (biasanya di `http://<IP-CasaOS>:81` atau port yang Anda set).
3. Login (Default: `admin@example.com` / `changeme`).
4. Buat Proxy Host:
Domain Names: Masukkan `homeassistant.local`
Scheme: `http`
Forward Hostname/IP: `127.0.0.1` (atau IP container jika beda network)
Forward Port: `8123` (Port Container dari Home Assistant).
5. Klik Save.
6. Hasil: Sekarang Anda bisa akses Home Assistant hanya dengan mengetik `homeassistant.local` di browser, tanpa perlu ingat port `8123`. Semua aplikasi bisa menggunakan port internalnya masing-masing tanpa takut tabrakan di port eksternal!
📖 BAB 5: TROUBLESHOOTING & MENCARI PORT "HANTU"
Terkadang, Anda sudah menghapus aplikasi, tapi portnya masih dianggap "terpakai" oleh CasaOS. Ini disebut *Ghost Port*.
Masalah 1: Error "Port is already allocated" saat install aplikasi baru.
Solusi:
1. Buka Dashboard CasaOS -> Settings (ikon gerigi) -> Docker.
2. Cari di daftar container, apakah ada aplikasi yang menggunakan port tersebut?
3. Jika ada aplikasi yang sudah tidak dipakai tapi statusnya *Stopped*, klik ikon Hapus (Trash) untuk menghapus container-nya sepenuhnya.
Masalah 2: Port masih bentrok padahal container sudah dihapus.
Solusi (Restart Docker):
Kadang Docker di dalam LXC Proxmox "lupa" melepaskan port.
1. Buka Console / SSH ke dalam container CasaOS.
2. Ketik perintah:
systemctl restart docker3. Tunggu beberapa detik, lalu cek kembali di UI CasaOS. Port seharusnya sudah bebas.
Masalah 3: Bagaimana cara melihat semua port yang sedang aktif?
Jika Anda ingin melihat daftar lengkap port apa saja yang sedang "duduk" di server CasaOS Anda:
1. Buka Console / SSH container CasaOS.
2. Jalankan perintah:
ss -tulpn | grep LISTEN*(Perintah ini akan menampilkan semua port yang sedang aktif mendengarkan koneksi beserta nama aplikasinya).*
🎯 PENUTUP
Konflik port adalah masalah paling umum bagi pemula di dunia Docker dan CasaOS. Dengan memahami perbedaan Port Host dan Port Container, menerapkan strategi penomoran, dan pada akhirnya beralih ke Reverse Proxy, Anda akan memiliki home server yang rapi, profesional, dan bebas dari headache akibat port yang bertabrakan.
Checklist Sebelum Install Aplikasi Baru:
- [ ] Cek apakah Port Host yang saya inginkan sudah dipakai?
- [ ] Apakah saya membiarkan Port Container tetap default?
- [ ] Sudahkah saya mencatat port ini di catatan saya?
*Selamat membangun ekosistem Docker yang harmonis!*
*(Catatan: Anda dapat menggabungkan buku panduan ini dengan buku panduan utama Proxmox-CasaOS yang sebelumnya untuk menciptakan "Kamus Lengkap Home Server" pribadi Anda.)*