dhcpcd development is moving to https://dev.marples.name

IF you have any tickets here, please re-create them at the new site!

dhcpcd - a DHCP client

Welcome to the project page for dhcpcd, a DHCP and DHCPv6 client. It's also an IPv4LL (aka ZeroConf) client.

In layman's terms, dhcpcd runs on your machine and silently configures your computer to work on the attached networks without trouble and mostly without configuration.

If you're a desktop user then you may also be interested in Network Configurator (dhcpcd-ui) which sits in the notification area and monitors the state of the network via dhcpcd. It also has a nice configuration dialog and the ability to enter a pass phrase for wireless networks.

dhcpcd may not be the only daemon running that wants to configure DNS on the host, so it uses resolvconf to ensure they can co-exist.

dhcpcd features

dhcpcd is the only open source DHCP client to support:-

Features shared with other clients

It should be noted that FreeBSD and several Linux distributions ship ISC dhclient with patches to enable Classless Static Routes.


dhcpcd is released under the 2 clause BSD license.


You should read the dhcpcd.conf man page and put your options into /etc/dhcpcd.conf. The default configuration file should work for most people just fine. Here it is, in case you lose it.

# A sample configuration for dhcpcd.
# See dhcpcd.conf(5) for details.

# Inform the DHCP server of our hostname for DDNS.
# To share the DHCP lease across OSX and Windows a ClientID is needed.
# Enabling this may get a different lease than the kernel DHCP client.
# Some upstream DHCP servers may also require a ClientID, such as FRITZ!Box.

# A list of options to request from the DHCP server.
option domain_name_servers, domain_name, domain_search, host_name
option classless_static_routes
# Most distributions have NTP support.
option ntp_servers
# Respect the network MTU.
option interface_mtu
# A ServerID is required by RFC2131.
require dhcp_server_identifier

The dhcpcd man page has a lot of the same options and more, which only apply to calling dhcpcd from the command line.

dhcpcd Mailing Lists

Currently there is just the dhcpcd-discuss mailing list, which is powered by mlmmj. One interacts with mlmmj via email.

To subscribe to the list, send an empty email to dhcpcd-discuss+subscribe@marples.name
Once subscribed to the list, you can post to it by sending an email to dhcpcd-discuss@marples.name
To unsubscribe from the list, send an empty email to dhcpcd-discuss+unsubscribe@marples.name
You can learn more about the capabilities of mlmmj by sending an empty mail to dhcpcd-discuss+help@marples.name

You can also read the dhcpcd-discuss archive