Cara Mengatur IP Statis dengan Netplan di Ubuntu

Langkah mengatur IP statis di Ubuntu dengan Netplan, format routes pengganti gateway4, cara aman memakai netplan try, dan solusi error yang umum.

Ditulis olehLucas Tan

Terbit 11 November 2026 5 menit baca

Jawaban singkat

Di Ubuntu, IP statis diatur lewat file YAML di /etc/netplan dengan blok addresses, routes (to default, via gateway), dan nameservers. Uji dulu dengan sudo netplan try agar konfigurasi otomatis dibatalkan bila koneksi SSH terputus, baru simpan permanen.

Daftar isi

Server Ubuntu-mu dapat IP baru setiap kali reboot, atau kamu perlu memasang IP tambahan dari penyedia? Di Ubuntu Server versi modern, semua itu diatur lewat Netplan: tulis file YAML di /etc/netplan/, uji dengan netplan try, lalu terapkan.

Netplan sendiri bukan pengelola jaringan. Ia membaca YAML lalu menerjemahkannya ke backend, yaitu systemd-networkd (umum di server) atau NetworkManager (umum di desktop). Karena itu, cara menulisnya sama di kedua jenis instalasi.

Langkah mengatur IP statis

1. Kenali nama antarmuka dan pengaturan saat ini

ip -br addr
ip route
resolvectl status

Catat nama antarmuka (misalnya ens3, eth0, atau enp1s0), alamat gateway dari baris default via ..., dan DNS yang dipakai. Kalau kamu sedang login lewat SSH ke VPS, siapkan juga akses konsol darurat dari panel penyedia. Satu salah ketik di file jaringan bisa memutus SSH.

2. Lihat file yang sudah ada

ls -l /etc/netplan/
sudo cat /etc/netplan/*.yaml

Di banyak VPS dan instalasi Ubuntu Server, file bawaannya bernama 50-cloud-init.yaml. Netplan membaca semua file .yaml di folder itu secara berurutan menurut nama, dan file yang belakangan bisa menimpa pengaturan file sebelumnya.

3. Cegah cloud-init menimpa pengaturanmu

Kalau file bawaan dibuat oleh cloud-init, perubahanmu bisa hilang saat instance dibuat ulang atau cloud-init menulis ulang konfigurasi. Komentar di bagian atas file biasanya menjelaskan hal ini. Matikan pengaturan jaringan oleh cloud-init dengan membuat file:

echo 'network: {config: disabled}' | sudo tee /etc/cloud/cloud.cfg.d/99-disable-network-config.cfg

Cara cloud-init bekerja dibahas lebih jauh di cara memakai cloud-init untuk menyiapkan VPS otomatis.

4. Tulis konfigurasi IP statis

Cadangkan dulu file lama, lalu buat file baru, misalnya /etc/netplan/60-static.yaml:

network:
  version: 2
  renderer: networkd
  ethernets:
    ens3:
      dhcp4: false
      addresses:
        - 203.0.113.25/24
      routes:
        - to: default
          via: 203.0.113.1
      nameservers:
        addresses: [1.1.1.1, 8.8.8.8]

Ganti nama antarmuka, alamat, prefix, dan gateway sesuai data dari penyedia. Ingat bahwa YAML peka spasi: pakai spasi, bukan tab, dan jaga indentasi tetap konsisten.

Kalau file lama masih mengatur antarmuka yang sama dengan DHCP, pindahkan file lama ke luar folder (misalnya ke /root/) agar tidak terjadi bentrok.

5. Rapikan izin file

sudo chmod 600 /etc/netplan/*.yaml

Versi Netplan yang lebih baru memberi peringatan bila file konfigurasi bisa dibaca semua pengguna, karena file ini bisa berisi data sensitif seperti kata sandi Wi-Fi.

6. Uji dengan netplan try

sudo netplan generate
sudo netplan try

netplan generate memeriksa sintaks tanpa menerapkan apa pun. netplan try menerapkan konfigurasi lalu menunggu konfirmasi. Kalau dalam batas waktu kamu tidak menekan Enter (misalnya karena SSH terputus), konfigurasi lama otomatis dikembalikan. Fitur inilah yang menyelamatkan banyak admin dari terkunci di luar servernya.

Batas waktu bawaannya 120 detik dan bisa diubah dengan opsi --timeout, misalnya sudo netplan try --timeout 60. Dokumentasi Netplan juga mengingatkan bahwa pembatalan otomatis kadang tidak berjalan sempurna, terutama untuk perangkat virtual seperti bridge atau bond. Jadi setelah pembatalan, tetap periksa ulang dengan ip addr bahwa konfigurasi lama benar-benar aktif kembali.

7. Terapkan dan periksa

Setelah konfirmasi di netplan try, konfigurasi sudah aktif. Periksa lagi:

ip -br addr show ens3
ip route
ping -c 3 1.1.1.1
resolvectl query ubuntu.com

Reboot sekali di jam sepi untuk memastikan pengaturan bertahan setelah server menyala ulang.

Kenapa gateway4 tidak dipakai lagi?

Banyak tutorial lama menulis gateway4: 203.0.113.1. Di dokumentasi Netplan sekarang, gateway4 dan gateway6 sudah ditandai deprecated dan pembaca diarahkan ke format routes dengan to: default. Penulisan lama mungkin masih dibaca, tapi netplan akan memberi peringatan. Gunakan format routes agar konfigurasi tetap aman di versi berikutnya.

Bagaimana menambah IP kedua atau IPv6?

Cukup tambahkan alamat di daftar addresses:

      addresses:
        - 203.0.113.25/24
        - 203.0.113.26/24
        - "2001:db8:10::25/64"
      routes:
        - to: default
          via: 203.0.113.1
        - to: "::/0"
          via: "2001:db8:10::1"

Alamat IPv6 sebaiknya diberi tanda kutip agar tanda titik dua tidak membingungkan pembaca YAML. Pengujian IPv6 lebih lengkap ada di cara mengaktifkan dan menguji IPv6 di VPS.

Ringkasan perintah dan error umum

Situasi	Perintah atau penyebab	Yang dilakukan
Cek sintaks tanpa menerapkan	`sudo netplan generate`	Perbaiki baris yang disebut di pesan error
Uji dengan pembatalan otomatis	`sudo netplan try`	Tekan Enter bila koneksi masih normal
Lihat hasil gabungan semua file	`sudo netplan get`	Pastikan tidak ada pengaturan ganda
Peringatan izin file terlalu longgar	File bisa dibaca semua pengguna	`chmod 600` pada file YAML
Peringatan gateway4 deprecated	Format lama	Ganti dengan `routes: - to: default`
Error "Invalid YAML"	Tab atau indentasi tidak konsisten	Ganti tab dengan spasi
IP kembali ke DHCP setelah reboot	Cloud-init menulis ulang file	Matikan konfigurasi jaringan cloud-init

Pertanyaan yang sering diajukan

Apa beda netplan apply dan netplan try?

netplan apply langsung menerapkan konfigurasi tanpa jalan mundur. netplan try menerapkan lalu membatalkan otomatis bila tidak dikonfirmasi, jadi lebih aman saat bekerja lewat SSH.

Apakah VPS perlu IP statis kalau DHCP dari penyedia selalu memberi alamat yang sama?

Tidak selalu. Kalau penyedia mengikat IP ke VPS lewat DHCP, pengaturan bawaan sudah cukup. IP statis manual dibutuhkan saat ada IP tambahan, rute khusus, atau penyedia memang meminta konfigurasi manual.

Bagaimana kalau SSH terputus setelah netplan apply?

Masuk lewat konsol darurat di panel penyedia, kembalikan file cadangan, lalu jalankan netplan apply lagi.

Apakah Netplan ada di Debian?

Debian memakai /etc/network/interfaces secara bawaan, walau beberapa image cloud Debian juga memakai Netplan. Periksa folder /etc/netplan untuk memastikannya.

Checklist singkat

Akses konsol darurat dari panel sudah siap.
File lama dicadangkan, file baru memakai format routes.
Cloud-init tidak lagi mengatur jaringan (bila relevan).
Izin file 600, netplan generate bersih tanpa error.
netplan try dikonfirmasi, lalu diuji ulang setelah reboot.