Ubuntu 26.04 LTS – netplan apply fails with YAML parser error – 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 changes fail to apply, leaving hosts unreachable after configuration updates.

Environment & Reproduction

Happens after manual edits in /etc/netplan with indentation or schema mistakes.

sudo netplan generate
sudo netplan apply

Root Cause Analysis

Invalid YAML syntax or wrong key placement causes netplan parser failure.

Quick Triage

Validate netplan file permissions, syntax, and renderer status.

ls -l /etc/netplan
sudo netplan --debug generate
systemctl status systemd-networkd NetworkManager

Step-by-Step Diagnosis

Review parser line numbers and compare with known-good schema structure.

sudo netplan --debug generate 2>&1 | tee /tmp/netplan-debug.log
sed -n '1,200p' /etc/netplan/*.yaml
grep -n 'Error' /tmp/netplan-debug.log

Solution – Primary Fix

Correct YAML indentation and keys, then regenerate and apply config safely.

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

Solution – Alternative Approaches

Recreate minimal working config and add advanced options incrementally.

sudo tee /etc/netplan/99-minimal.yaml >/dev/null <<'EOF'
network:
  version: 2
  ethernets:
    enp0s3:
      dhcp4: true
EOF
sudo netplan apply

Verification & Acceptance Criteria

Interfaces are up with expected addressing and routes after apply.

ip -br a
ip route
resolvectl status

Rollback Plan

Restore the previous netplan file from backup and reapply.

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

Prevention & Hardening

Use netplan try for remote systems and validate YAML before deployment.

sudo netplan generate
yamllint /etc/netplan/*.yaml 2>/dev/null || true

Related Errors & Cross-Refs

Often connected with renderer mismatch and interface name drift after kernel updates.

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

View all Ubuntu 26.04 LTS tutorials on the Tutorials Hub →

Browse all common problems & solutions on the Tutorials Hub.

References & Further Reading

Ubuntu netplan reference and systemd-networkd integration docs.