Ubuntu 24.04 LTS – netplan apply fails and network stays down – 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

Interfaces fail to come up, causing loss of SSH and outbound connectivity.

Environment & Reproduction

Common after editing /etc/netplan files.

lsb_release -a
ip a
sudo netplan apply

Root Cause Analysis

YAML indentation mistakes, wrong interface names, or renderer mismatch break configuration.

Quick Triage

Generate and inspect current netplan interpretation.

sudo netplan --debug generate
networkctl status
ls /etc/netplan

Step-by-Step Diagnosis

Validate interface names and YAML schema.

ip -br link
sudo netplan get
sudo python3 -c 'import yaml,glob; [yaml.safe_load(open(f)) for f in glob.glob("/etc/netplan/*.yaml")]'

Solution – Primary Fix

Correct YAML and reapply safely.

sudo cp -a /etc/netplan /var/tmp/netplan.bak.$(date +%s)
sudoedit /etc/netplan/01-netcfg.yaml
sudo netplan generate
sudo netplan apply

Solution – Alternative Approaches

Use interactive rollback mode to avoid lockout.

sudo netplan try
# confirm within timeout if network works

Verification & Acceptance Criteria

Interface has expected address and routes.

ip -4 a
ip r
ping -c 3 1.1.1.1

Rollback Plan

Restore last known working netplan files.

sudo rm -f /etc/netplan/*.yaml
sudo cp -a /var/tmp/netplan.bak.*/netplan/* /etc/netplan/
sudo netplan apply

Prevention & Hardening

Keep one config per interface and validate before apply.

sudo netplan generate
sudo netplan try
git -C /etc/netplan init 2>/dev/null || true

Related Errors & Cross-Refs

Often appears with cloud-init overriding local network settings.

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 and systemd-networkd reference guides.