[NETBIRD] ADD CLIENT - fourslickz/notes GitHub Wiki

🧩 Panduan Menambahkan Client Kedua di NetBird Self-Hosted

Dokumen ini menjelaskan langkah-langkah untuk menambahkan client kedua (atau lebih) ke dalam jaringan NetBird self-hosted yang sudah berjalan.

📘 1. Informasi Server Self-Hosted

Pastikan kamu sudah memiliki informasi berikut dari setup awal:

Parameter Contoh
Dashboard URL https://dashboard.netbird.example.com
Management API URL https://api.netbird.example.com
Signal URL signal.netbird.example.com:10000

Pastikan ketiga alamat di atas bisa diakses dari client baru.

💻 2. Instalasi NetBird di Client Baru

🔹 Linux (Ubuntu/Debian)

curl -fsSL https://pkgs.netbird.io/install.sh | bash
sudo netbird up --login-url https://dashboard.netbird.example.com

Setelah menjalankan perintah di atas:

  • Browser akan terbuka otomatis (atau tampil link untuk dikunjungi manual).
  • Login menggunakan akun dashboard (OIDC atau lokal admin).
  • Perangkat otomatis muncul di dashboard sebagai peer baru.

🔹 Windows

  1. Unduh installer:

    https://github.com/netbirdio/netbird/releases/latest

    Pilih file: netbird_installer_windows_amd64.msi

  2. Instal seperti biasa.

  3. Jalankan Command Prompt (Run as Administrator):

    netbird up --login-url https://dashboard.netbird.example.com

🔹 macOS

brew install netbirdio/tap/netbird
sudo netbird up --login-url https://dashboard.netbird.example.com

🧠 3. Verifikasi Client di Dashboard

Buka Dashboard NetBird:

https://dashboard.netbird.example.com

Masuk ke tab Peers
➡️ Kamu akan melihat device baru muncul dalam daftar.

Status akan berubah menjadi Connected jika koneksi mesh sudah aktif.

🔐 4. Uji Koneksi Antar Peer

Dari client pertama, ping ke IP internal mesh milik client kedua:

ping 100.64.0.2

Ganti dengan IP peer kedua yang terlihat di dashboard.

Jika mendapat balasan ✅ berarti koneksi mesh antar peer berhasil.

⚙️ 5. (Opsional) Tambahkan Access Policy

Jika kamu mengaktifkan Access Control, pastikan peer kedua diizinkan untuk berkomunikasi.

Langkah:

  1. Buka Access Control → Add Policy
  2. Pilih group atau peer yang ingin diizinkan saling akses
  3. Simpan policy

🧩 6. Jalankan Service Secara Otomatis

Linux

sudo systemctl enable --now netbird

Windows

Pastikan service NetBird Service berstatus Running.

🛠️ 7. (Opsional) Skrip Otomatis untuk Client Baru (Linux)

Jika kamu ingin menambahkan banyak client sekaligus:

Buat file install-netbird-client.sh:

#!/bin/bash
# Install & Register NetBird Client otomatis
SERVER_DASHBOARD="https://dashboard.netbird.example.com"

curl -fsSL https://pkgs.netbird.io/install.sh | bash
sudo netbird up --login-url $SERVER_DASHBOARD
sudo systemctl enable --now netbird

Jalankan dengan:

chmod +x install-netbird-client.sh
./install-netbird-client.sh

✅ Selesai

Client kedua (dan seterusnya) kini sudah tergabung ke jaringan NetBird self-hosted kamu.
Semua koneksi antar peer otomatis terenkripsi dengan WireGuard 🔒 dan dikelola lewat dashboard kamu sendiri.

Dokumen ini dibuat oleh:
🧠 AlienskyID — DevOps & Network Engineer
📅 Terakhir diperbarui: 2025-10-16