Langkah 1 - Instal Docker di Linux
Sebelum kita memulai, Anda perlu menginstal Docker Engine di sistem Anda. Panduan di bawah ini dapat digunakan untuk mencapai ini:
Cara Menginstal Docker CE pada Sistem Linux
Setelah diinstal, pastikan layanan Docker berjalan:
sudo systemctl start docker && sudo systemctl enable docker
Tambahkan pengguna sistem Anda ke grup Docker:
sudo usermod -aG docker $USER
newgrp docker
Langkah 2 - Konfigurasi Volume Persisten
Volume persisten digunakan untuk menyimpan data kontainer sehingga tidak hilang saat sistem direstart. Untuk panduan ini, kita akan membuat path untuk penyimpanan data di /unifi_data/config:
sudo mkdir -p /unifi_data/config
Atur izin yang benar:
sudo chmod 775 -R /unifi_data/config
Agar path tersebut dapat diakses, kita perlu mengonfigurasi SELinux pada sistem berbasis RHEL seperti yang ditunjukkan:
sudo setenforce 0
sudo sed -i 's/^SELINUX=.*/SELINUX=permissive/g' /etc/selinux/config
Langkah 3 - Menjalankan UniFi Controller dalam Kontainer Docker
Setelah Docker Engine diinstal, Anda dapat dengan mudah menjalankan UniFi Controller dari baris perintah Docker.
Perintah ini memiliki beberapa parameter yang mencakup:
-p untuk beberapa port. Port-port ini digunakan untuk layanan yang berbeda:
8443 – Port admin web Unifi
3478/udp – Port STUN Unifi
10001/udp – Diperlukan untuk penemuan AP
8843 – Port pengalihan HTTPS portal tamu Unifi
8880 – Port pengalihan HTTP portal tamu Unifi
8080 – Diperlukan untuk komunikasi perangkat
1900/udp – Diperlukan untuk membuat pengontrol terlihat pada opsi jaringan L2
6789 – Untuk pengujian throughput seluler
5514/udp – Port Syslog jarak jauh
-e untuk variabel lingkungan seperti:
PUID dan PGID yang mendefinisikan izin pengguna dan grup untuk menghindari kesalahan yang timbul antara sistem host dan kontainer karena volume/path persisten
MEM_LIMIT dan MEM_STARTUP digunakan untuk mengonfigurasi memori Java, Anda dapat mengatur nilainya sebagai nilai default
-v mendefinisikan volume untuk menyimpan data kontainer.
Sekarang Anda dapat menjalankan kontainer UniFi Controller dengan semua parameter yang ditentukan seperti yang ditunjukkan:
docker run -d \
--name=unifi-controller \
-e PUID=1000 \
-e PGID=1000 \
-e MEM_LIMIT=1024 #opsional \
-e MEM_STARTUP=1024 #opsional \
-p 8443:8443 \
-p 3478:3478/udp \
-p 10001:10001/udp \
-p 8080:8080 \
-p 1900:1900/udp #opsional \
-p 8843:8843 #opsional \
-p 8880:8880 #opsional \
-p 6789:6789 #opsional \
-p 5514:5514/udp #opsional \
-v /unifi_data/config:/config \
--restart unless-stopped \
lscr.io/linuxserver/unifi-controller:latest
Langkah 4 - Menjalankan UniFi Controller menggunakan Docker Compose (Disarankan)
Anda juga dapat menjalankan UniFi Controller menggunakan Docker Compose. Pertama, pastikan Docker Compose diinstal di sistem Anda.
Cara Menginstal Docker Compose di Linux
Setelah diinstal, buat file docker-compose dengan semua parameter yang didefinisikan:
vim docker-compose.yml
File akan berisi baris-baris berikut:
version: "2.1"
services:
unifi-controller:
image: lscr.io/linuxserver/unifi-controller:latest
container_name: unifi-controller
environment:
- PUID=1000
- PGID=1000
- MEM_LIMIT=1024 #opsional
- MEM_STARTUP=1024 #opsional
volumes:
- /unifi_data/config:/config
ports:
- 8443:8443
- 3478:3478/udp
- 10001:10001/udp
- 8080:8080
- 1900:1900/udp #opsional
- 8843:8843 #opsional
- 8880:8880 #opsional
- 6789:6789 #opsional
- 5514:5514/udp #opsional
restart: unless-stopped
Simpan file dan jalankan kontainer dengan perintah:
docker-compose up -d
Langkah 5 - Akses Antarmuka Web UniFi Controller
Sekarang akses antarmuka web UniFi Controller menggunakan URL https://Alamat_IP:8443, di mana Alamat_IP harus diganti dengan alamat IP sesuai dengan sistem Anda. Ini akan membuka antarmuka web UniFi Controller, yang memungkinkan Anda mengelola dan mengawasi jaringan UniFi Anda dengan mudah. Selamat menggunakan UniFi Controller untuk mengoptimalkan jaringan Anda!