Install 9router di Docker Ubuntu

Syarat sebelum mulai

Pastikan Ubuntu kamu sudah memenuhi persyaratan berikut:

• Ubuntu 22.04, 24.04, atau versi yang didukung Docker Engine.
• Koneksi internet untuk mengunduh Docker dan image 9Router.
• Akses terminal dengan akun yang mempunyai hak sudo.
• Arsitektur prosesor AMD64 atau ARM64.

1. Install Docker di Ubuntu

Kalau Docker belum terpasang, pertama-tama update paket Ubuntu:

sudo apt update
sudo apt install -y ca-certificates curl

Tambahkan GPG key resmi Docker:

sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

Selanjutnya tambahkan repository Docker:

sudo tee /etc/apt/sources.list.d/docker.sources > /dev/null <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "$${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

Update repository dan install Docker Engine:

sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Aktifkan Docker dan pastikan servicenya berjalan:

sudo systemctl enable --now docker
sudo systemctl status docker

Untuk memastikan instalasi berhasil, jalankan:

sudo docker --version
sudo docker run --rm hello-world

2. Download Image 9Router

Setelah Docker aktif, download image resmi 9Router dari Docker Hub:

sudo docker pull decolua/9router:latest

Buat folder penyimpanan data agar konfigurasi 9Router tidak hilang ketika container diperbarui:

mkdir -p "$HOME/.9router"

Selanjutnya jalankan container 9Router:

sudo docker run -d \
  --name 9router \
  --restart unless-stopped \
  -p 127.0.0.1:20128:20128 \
  -v "$HOME/.9router:/app/data" \
  -e DATA_DIR=/app/data \
  decolua/9router:latest

Berikut penjelasan parameter yang digunakan:

• -d — Menjalankan container di background.
• --name 9router — Memberikan nama pada container.
• --restart unless-stopped — Mengaktifkan kembali container setelah Docker atau sistem restart, kecuali container dihentikan secara manual.
• -p 127.0.0.1:20128:20128 — Membuka dashboard melalui localhost saja.
• -v "$HOME/.9router:/app/data" — Menyimpan data aplikasi di folder host.
• -e DATA_DIR=/app/data — Mengatur direktori data aplikasi di dalam container.

3. Cek Status dan Akses 9Router

Pastikan container 9Router sudah berjalan dengan perintah:

sudo docker ps

Kalau container bernama 9router muncul dengan status Up, berarti aplikasi sudah aktif.

Selanjutnya buka alamat berikut melalui browser di komputer Ubuntu yang menjalankan Docker:

http://localhost:20128

Untuk memeriksa aktivitas dan kemungkinan error aplikasi, gunakan:

sudo docker logs --tail 100 9router

Jika ingin memantau log secara langsung:

sudo docker logs -f 9router

Tekan Ctrl + C untuk keluar dari tampilan log. Container tetap berjalan di background.

4. Konfigurasi Tambahan

Secara default, konfigurasi dan database 9Router sudah disimpan di folder:

$HOME/.9router

Struktur penyimpanan data antara lain:

~/.9router/
├── db/
│   ├── data.sqlite
│   └── backups/
└── ...

Untuk melihat lokasi folder penyimpanan di Ubuntu:

ls -lah "$HOME/.9router"

Jika ingin melakukan backup, hentikan container terlebih dahulu agar database tidak sedang ditulis:

sudo docker stop 9router
sudo tar -czf "$HOME/9router-backup.tar.gz" -C "$HOME" .9router
sudo docker start 9router

File backup akan tersimpan sebagai 9router-backup.tar.gz di direktori home.

5. Mengelola Container 9Router

Berikut beberapa perintah Docker untuk mengelola aplikasi 9Router.

Restart container:

sudo docker restart 9router

Menghentikan container:

sudo docker stop 9router

Menjalankan kembali container:

sudo docker start 9router

Melihat penggunaan resource container:

sudo docker stats 9router

Melihat informasi container:

sudo docker inspect 9router

6. Update 9Router ke Versi Terbaru

Untuk memperbarui 9Router, download image terbaru:

sudo docker pull decolua/9router:latest

Setelah selesai, hentikan dan hapus container lama:

sudo docker stop 9router
sudo docker rm 9router

Kemudian jalankan container baru dengan konfigurasi penyimpanan data yang sama:

sudo docker run -d \
  --name 9router \
  --restart unless-stopped \
  -p 127.0.0.1:20128:20128 \
  -v "$HOME/.9router:/app/data" \
  -e DATA_DIR=/app/data \
  decolua/9router:latest

Pastikan container berjalan normal setelah update:

sudo docker ps
sudo docker logs --tail 50 9router

Untuk melihat versi aplikasi yang terinstall, kamu bisa mencoba perintah berikut:

sudo docker exec 9router node -p "require('./package.json').version"

Kesimpulan

Install 9Router di Ubuntu menggunakan Docker cukup mudah. Kamu hanya perlu menyiapkan Docker, mengunduh image resmi, menjalankan container, lalu mengakses dashboard melalui browser.

Dengan menyimpan database di folder host, kamu juga bisa melakukan update image tanpa kehilangan konfigurasi aplikasi.