---
name: "dhcpleased.conf"
section: "5"
platform: "openbsd"
package: "man"
version: "8.0-current-20261101"
release: "OpenBSD 8.0-current (2026-11-01)"
platforms: ["openbsd"]
url: "https://new.carta.tech/dhcpleased.conf"
---

# dhcpleased.conf(5)

DHCP client configuration file

## NAME

**dhcpleased.conf** – DHCP client configuration file

## DESCRIPTION

The [dhcpleased(8)](/dhcpleased/8.md) 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)](/dhcpleased/8.md) configuration file.

## SEE ALSO

[dhcpleasectl(8)](/dhcpleasectl/8.md), [dhcpleased(8)](/dhcpleased/8.md)