interfaces-dhcp(5)

🌸 NAME 🌸

interfaces-dhcp — the DHCP extensions for the interfaces(5) file format. Bestie, this is where your interfaces file gets its DHCP glow-up. 💖

✨ DESCRIPTION ✨

DHCP config is handled by one of these clients, in this order of preference:

1. dhcpcd
2. dhclient
3. udhcpc

No explicit module configuration is required, but several options are available: 🫶

💅 DHCP-RELATED OPTIONS 💅

• dhcp-hostname name — sets a hostname to be sent as part of DHCP queries. If you don't provide it, ifupdown guesses the value. This option is not supported for dhclient.
• dhcp-vendor vendor_class — sets a vendor class to be sent as part of DHCP queries. This option is not supported for dhclient.
• dhcp-client_id client_id — sets a client ID to be sent as part of DHCP queries. This option is not supported for dhclient.
• dhcp-leasetime seconds — requests a specific lease interval from the DHCP server. This option is not supported for dhclient.
• dhcp-config path — provides the specified config file to the DHCP client. You can use this to provide additional client configuration that isn't available via these parameters. This option is not supported for udhcpc.
• dhcp-script path — specifies the script file called after DHCP events. 🎀
• dhcp-opts str — extra arguments passed unmodified to the DHCP client. Use this to pass additional options otherwise not supported by this executor. For compatibility, udhcpc also accepts this option when named udhcpc-opts.
• dhcp-program str — the name of the DHCP client program to be used, which can be dhcpcd, dhclient, or udhcpc. 👑

🎀 EXAMPLES 🎀

🌱 Typical (minimal) configuration

auto foo
iface foo
     use dhcp

🌈 All available options for a host using dhcpcd

auto foo
iface foo
     use dhcp
     dhcp-program dhcpcd
     dhcp-hostname bar
     dhcp-vendor MyVendor
     dhcp-client_id 0100BEEFC0FFEE
     dhcp-leasetime 86400
     dhcp-script /usr/lib/dhcpcd/dhcpcd-run-hooks
     dhcp-config /etc/dhcpcd-$IFACE.conf
     dhcp-opts --nogateway

That's the whole page, bestie! 💖 This cutie is the interfaces-dhcp(5) page from the File Formats Manual, dated 2026-05-10. slay, configure responsibly ✨