---
name: "udhcpd.conf"
section: "5"
platform: "linux"
package: "udhcpd"
version: "1:1.37.0-6"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/udhcpd.conf"
---

# udhcpd.conf(5)

udhcp server configuration file

## NAME

udhcpd.conf - udhcp server configuration file

## DESCRIPTION

The file */etc/udhcpd.conf* contains configuration information specific to the udhcp server. It should contain one configuration keyword per line, followed by appropriate configuration information.

## OPTIONS

- **start** *ADDRESS*

  The starting address of the IP lease block is *ADDRESS*. The default is **192.168.0.20**.

- **end** *ADDRESS*

  The ending address of the IP lease block is *ADDRESS*. The default is **192.168.0.254**.

- **interface** *INTERFACE*

  The udhcp server should listen on *INTERFACE*. The default is **eth0**.

- **max\_leases** *LEASES*

  Offer at most *LEASES* leases (including those reserved by OFFERs, DECLINEs, and ARP conflicts).  The default is **254**.

- **auto\_time** *SECONDS*

  Write the lease information to a file every *SECONDS* seconds.  The default is **7200**.

- **decline\_time** *SECONDS*

  Reserve an IP for *SECONDS* seconds if a DHCP decline message is received.  The default is **3600**.

- **conflict\_time** *SECONDS*

  Reserve an IP for *SECONDS* seconds if an ARP conflict occurs.  The default is **3600**.

- **offer\_time** *SECONDS*

  Reserve an IP for *SECONDS* seconds if it is offered.  The default is **60**.

- **min\_lease** *SECONDS*

  Reserve an IP for the full lease time if the lease to be given is less than *SECONDS* seconds.  The default is **60**.

- **lease\_file** *FILE*

  Write the lease information to *FILE*. The default is **/var/lib/misc/udhcpd.leases**.

- **pidfile** *FILE*

  Write the process ID to *FILE*. The default is **/var/run/udhcpd.pid**.

- **notify\_file** *FILE*

  Execute *FILE* after the lease information is written.  By default, no file is executed.

- **siaddr** *ADDRESS*

  BOOTP specific option.  The default is **0.0.0.0**.

- **sname** *NAME*

  BOOTP specific option.  There is no default.

- **boot\_file** *FILE*

  BOOTP specific option.  There is no default.

- **static\_lease** *MACADDRESS IPADDRESS*

  Issue IPADDRESS statically to a requester with MACADDRESS.

- **option** *OPTION*

  DHCP specific option.

  - **subnet** *ADDRESS*

    - **timezone** *OFFSET*

    - **router** *ADDRESS...*

    - **timesvr** *ADDRESS...*

    - **namesvr** *ADDRESS...*

    - **dns** *ADDRESS...*

    - **logsvr** *ADDRESS...*

    - **cookiesvr** *ADDRESS...*

    - **lprsvr** *ADDRESS...*

    - **hostname** *HOSTNAME*

    - **bootsize** *SIZE*

    - **domain** *DOMAIN*

    - **swapsvr** *ADDRESS*

    - **rootpath** *PATH*

    - **ipttl** *TTL*

    - **mtu** *MTU*

    - **broadcast** *ADDRESS*

    - **ntpsrv** *ADDRESS...*

    - **wins** *ADDRESS...*

    - **requestip** *ADDRESS*

    - **lease** *SECONDS*

    - **dhcptype** *TYPE*

    - **serverid** *ADDRESS*

    - **tftp** *FILE*

    - **wpad URL**

    - **bootfile** *FILE*

    The default for **lease** is **864000**. There are no defaults for the other options.

## SEE ALSO

[**udhcpd**(8)](/udhcpd/8.md).