DHCPLEASED.CONF(5) | File Formats Manual | DHCPLEASED.CONF(5)

# NAME

`dhcpleased.conf` — DHCP client configuration file

# DESCRIPTION

The dhcpleased(8) daemon is a dynamic host configuration protocol client daemon.

The `dhcpleased.conf` config file is divided into the following main sections:

Macros
  Definitions of variables that can be used later, simplifying the configuration file.
Interfaces
  If an interface requires non-default options, they can be defined in this section. Most configurations do not require this.

## Macros

A macro is defined with a command of the form name=value. The macro name can contain letters, digits, and underscores and cannot be a reserved word (for example, `interface`). Within unquoted arguments, the string $name is later expanded to value.

## Interfaces

A list of interfaces to overwrite defaults:

`interface` name {option ...}

  `interface` options are as follows:

  `ignore dns`
    Ignore nameservers from leases on this interface. The default is to not ignore nameservers.
  `ignore routes`
    Ignore routes from leases on this interface. The default is to not ignore routes.
  `ignore` server-ip
    Ignore leases from server-ip. This option can be listed multiple times. The default is to not ignore servers.
  `prefer ipv6`
    Send the IPv6-Only preferred option to the server. If the server responds with the option, no lease is configured.
  `send client id` client-id
    Send the DHCP client identifier option with a value of client-id. If client-id consists of a series of octets of two-digit hexadecimal numbers separated by colons, the first octet is used as the type and the rest as value. The MAC address 00:53:FF:AA:BB:CC would be configured as:

        send client id "01:00:53:FF:AA:BB:CC"

    Otherwise the string client-id is sent verbatim. The default is to send the interface's MAC address as client identifier.

    When client-id is not a hardware address, it is supposed to be sent as hardware type 0 but the majority of DHCP clients and servers do not implement this and neither does `dhcpleased.conf`. If a server is encountered that requires this, a 0 byte can be encoded as \0. The client identifier “foobar” with hardware type 0 would be configured as:

        send client id "\0foobar"

  `send host name` host-name
    Send the DHCP client host name option with a value of host-name. The default is to send the name of the host.
  `send no host name`
    Do not send a DHCP host name option. The default is to send a DHCP host name option with the name of the host.
  `send vendor class id` vendor-class-id
    Send the DHCP vendor class identifier option with a value of vendor-class-id. The default is to not send a vendor class identifier.

# FILES

/etc/dhcpleased.conf
  dhcpleased(8) configuration file.

# SEE ALSO

dhcpleasectl(8), dhcpleased(8)

July 8, 2025 | Debian