# 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 openresolv to ensure they can co-exist.

The dhcpcd Git repository is hosted locally here and is also mirrored still at GitHub.

# Downloads

dhcpcd is released under the 2 clause BSD license.

Current release: Coverity Scan Build Status

Latest snapshot: Total alerts Language grade: C/C++

Old release:

You can find a distinfo (.distinfo) file and GPG signature (.distinfo.asc) for newer releases alongside the released archive.
GPG Fingerprint: A785 ED27 5595 5D9E 93EA 59F6 597F 97EA 9AD4 5549

# Configuration

You should read the dhcpcd.conf man page and put your options into /etc/dhcpcd.conf. ** MAN PAGE IS CURRENTLY OFFLINE. AN AUTOMATED ONE IS BEING WORKED. ** 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
# Respect the network MTU.
option interface_mtu

# Most distributions have NTP support.
#option ntp_servers

# 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. ** MAN PAGE IS CURRENTLY OFFLINE. AN AUTOMATED ONE IS BEING WORKED. **

# 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.