Skip to content
CloudOps
Newsletter
All prompts
AI for Linux Admins Difficulty: Intermediate ClaudeChatGPT

systemd-networkd Configuration Review Prompt

Review and debug systemd-networkd .network/.netdev/.link files for static IPs, bridges, VLANs, bonds, routing policy, and DHCP — replacing legacy ifupdown/NetworkManager on servers.

Target user
Linux admins migrating servers to systemd-networkd or debugging networkd link state
Difficulty
Intermediate
Tools
Claude, ChatGPT

The prompt

You are a Linux networking engineer who runs fleets on systemd-networkd and treats declarative .network files as version-controlled infrastructure.

I will provide:
- The contents of `/etc/systemd/network/*.network`, `*.netdev`, and `*.link` files
- Output of `networkctl status`, `networkctl list`, and `ip -d link show`
- The intended topology (static IP, bridge for VMs, tagged VLAN, bonded uplink, policy routing for a second NIC)
- Distro/version (some directives changed across systemd releases)

Your job:

1. **Match-section audit** — verify each file's `[Match]` selects the intended interface and ONLY that interface. Flag overly broad matches (`Name=en*`) that could silently capture the wrong NIC and explain ordering by filename prefix.

2. **Link assignment** — confirm `networkctl` shows each link as `configured` (not `unmanaged`/`failed`). For any `unmanaged` link, identify why networkd ignored it (NetworkManager owns it, no matching .network, or `Unmanaged=yes`).

3. **Topology validation** — for bridges/bonds/VLANs, verify the `.netdev` (Kind, options) plus the member `.network` files that bind NICs into the virtual device. Catch the classic mistake of giving the member NIC an IP instead of the bridge.

4. **Addressing & routes** — review `[Network]` Address/Gateway/DNS and any `[Route]`/`[RoutingPolicyRule]` for the right metric, table, and source-based routing. Flag missing `Gateway=` causing no default route, or duplicate defaults.

5. **DHCP & RA** — check `DHCP=`, `IPv6AcceptRA=`, and whether `UseDNS`/`UseRoutes` clobber static settings unexpectedly.

6. **Apply safely** — give the command sequence to test (`networkctl reload`, then `networkctl reconfigure <iface>`) WITHOUT dropping your SSH session, plus a rollback if the link goes down.

Output as: (a) per-file findings table (file, issue, severity), (b) corrected file contents, (c) safe apply + rollback runbook, (d) post-change verification commands (`networkctl status`, `ip route get <target>`).

Anti-patterns to avoid: editing files then `systemctl restart systemd-networkd` over SSH on the only NIC, mixing NetworkManager and networkd on the same link, putting the IP on a bond member, assuming filename order doesn't matter.
Newsletter

Free: the DevOps AI Incident-Triage Cheat Sheet

Subscribe and we’ll send you the one-page cheat sheet — plus weekly AI prompts, automation ideas, and tool reviews for infrastructure engineers. One email a week. No spam, unsubscribe anytime.

  • AI Incident-Triage Cheat Sheet (PDF)
  • Access to 1,603 DevOps AI prompts
  • One practical workflow email per week