Skip to content
Branch: master
Find file Copy path
Find file Copy path
5 contributors

Users who have contributed to this file

@frenck @AdighaLogic @CanDoAnything @scop @balloob
158 lines (104 sloc) 4.56 KB

Home Assistant Add-on: DHCP server

A simple DHCP server.

Supports aarch64 Architecture Supports amd64 Architecture Supports armhf Architecture Supports armv7 Architecture Supports i386 Architecture


This add-on provides a simple DHCP server for your network. It provides some basic needs, like, reserving IP addresses for your devices to ensure they always get assigned the same IP address.


Follow these steps to get the add-on installed on your system:

  1. Navigate in your Home Assistant frontend to Supervisor -> Add-on Store.
  2. Find the "DHCP server" add-on and click it.
  3. Click on the "INSTALL" button.

How to use

  1. Set the domain option, e.g., mynetwork.local.
  2. Save the add-on configuration by clicking the "SAVE" button.
  3. Start the add-on.


The DHCP server add-on can be tweaked to your likings. This section describes each of the add-on configuration options.

Example add-on configuration:

domain: mynetwork.local
default_lease: 86400
max_lease: 172800
  - subnet:
    interface: eth0
  - name: webcam_xy
    mac: aa:bb:ee:cc

Option: domain (required)

Your network domain name, e.g., mynetwork.local or home.local

Option: dns (required)

The DNS servers your DHCP server gives to your clients. This option can contain a list of servers. By default, it is configured to have Google's public DNS servers: `"", "".

Option: default_lease (required)

The default time in seconds that the IP is leased to your client. Defaults to 86400, which is one day.

Option: max_lease (required)

The max time in seconds that the IP is leased to your client. Defaults to 172800, which is two days.

Option: networks (one item required)

This option defines settings for one or multiple networks for the DHCP server to hand out IP addresses for.

At least one network definition in your configuration is required for the DHCP server to work.

Option: networks.subnet

Your network schema/subnet. For example, if your IP addresses are 192.168.1.x the subnet becomes

Option: networks.netmask

Your network netmask. For example, if your IP addresses are 192.168.1.x the netmask becomes

Option: networks.range_start

Defines the start IP address for the DHCP server to lease IPs for. Use this together with the range_end option to define the range of IP addresses the DHCP server operates in.

Option: networks.range_end

Defines the end IP address for the DHCP server to lease IPs for.

Option: networks.broadcast

The broadcast address specific to the lease range. For example, if your IP addresses are 192.168.1.x, the broadcast address is usually

Option: networks.gateway

Sets the gateway address for that the DHCP server hands out to its clients. This is usually the IP address of your router.

Option: networks.interface

The network interface to listen to for this network, e.g., eth0.

Option: hosts (optional)

This option defines settings for one or host definitions for the DHCP server.

It allows you to fix a host to a specific IP address.

By default, non are configured.


The name of the hostname you'd like to fix an address for.

Option: hosts.mac

The MAC address of the client device.

Option: hosts.ip

The IP address you want the DHCP server to assign.


Got questions?

You have several options to get them answered:

In case you've found a bug, please open an issue on our GitHub.

You can’t perform that action at this time.