Ubuntu 24.04 LTS – netplan apply causes network outage – Fix & Prevention

📖 ~1 min read

Table of contents

1. Symptom & Impact
2. Environment & Reproduction
3. Root Cause Analysis
4. Quick Triage
5. Step-by-Step Diagnosis
6. Solution – Primary Fix
7. Solution – Alternative Approaches
8. Verification & Acceptance Criteria
9. Rollback Plan
10. Prevention & Hardening
11. Related Errors & Cross-Refs
12. References & Further Reading

Symptom & Impact

Network goes down immediately after applying netplan changes.

Environment & Reproduction

Often triggered by wrong interface names, indentation errors, or invalid routes.

ip link
ls /etc/netplan
sudo netplan apply

Root Cause Analysis

YAML syntax or device mapping errors prevent backend network configuration from applying correctly.

Quick Triage

Validate YAML and backend generation before reapplying.

sudo netplan generate
sudo netplan get
journalctl -u systemd-networkd -n 80 --no-pager

Step-by-Step Diagnosis

Confirm NIC names and compare active state with netplan definitions.

ip -br link
cat /etc/netplan/*.yaml
networkctl status

Solution – Primary Fix

Correct interface mapping, use netplan try, and commit only validated config.

sudo cp /etc/netplan/01-netcfg.yaml /etc/netplan/01-netcfg.yaml.bak
sudoedit /etc/netplan/01-netcfg.yaml
sudo netplan try
sudo netplan apply

Solution – Alternative Approaches

Temporarily configure address via ip command to regain remote access.

sudo ip addr add 192.0.2.10/24 dev eth0
sudo ip route add default via 192.0.2.1

Verification & Acceptance Criteria

Interface is up with correct IP, route, and DNS after reboot and apply.

ip a
ip r
resolvectl status
sudo reboot

Rollback Plan

Restore previous YAML and reapply if connectivity breaks again.

sudo cp /etc/netplan/01-netcfg.yaml.bak /etc/netplan/01-netcfg.yaml
sudo netplan apply

Prevention & Hardening

Use staged rollouts with netplan try and keep console access for remote hosts.

sudo netplan try

Related Errors & Cross-Refs

Related errors include YAML parser failures and no carrier after apply.

Related tutorial: View the step-by-step tutorial for Ubuntu 24.04 LTS.

View all Ubuntu 24.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu netplan examples and systemd-networkd operational guidance.