LEDE/OpenWRT — Defining Static DHCP Leases

With LEDE/OpenWRT you have the ability to have more specific control over your devices DHCP leases.

This guide will walk you through some of the fine tuning options you have.

SSH to your LEDE/OpenWRT device

If you are using Windows then start PuTTY and click Session on the left side, select SSH from the options, and then enter in the IP Address of your LEDE/OpenWRT box into the Host Name field.

Once you’ve done this just click on Open to start up the SSH connection.


If you are connecting via terminal, then just SSH to your LEDE/OpenWRT device using the following command, where is your LEDE/OpenWRT device’s IP address.

ssh root@

Defining Static DHCP Leases

Static DHCP leases allow you do define IP addresses for specific devices based off their MAC addresses.

All of the changes mentioned will be made in the following file unless otherwise specified, so run the following command:

vi /etc/config/dhcp

In this file you can define a static DHCP lease with something similar to the following:

config host
option ip ''
option mac '00:aa:11:bb:22:cc'
option name 'desktop'

The options listed in this example mean the following:

  • ip: This defines the IP address that you want to associate to a specific device.
  • mac: This defines the MAC address of the device(s). You can add multiple MAC addresses separated by commas, however this can cause issues if more than one of them are in use at the same time.
  • name: This assigns the lease a name. This will help you identify which rule is which, as a name is easier to recognise than a MAC address.

You can add in as many of these rules as you want need. Assigning static IPs to the devices you want will help with a lot of things, such as port forwarding.

As with dynamic DHCP leases, you can define the lease time by adding in the following option:

option leasetime 20h

If you found this post helpful please let us know by clicking the ♥ below.

This blog was brought to you by Cucumber Wi-Fi. Cucumber helps you run a more efficient Wi-Fi network. Check it out here.

Cucumber Wi-Fi — control any (Wi-Fi) device from the cloud.

Like what you read? Give CT WiFi a round of applause.

From a quick cheer to a standing ovation, clap to show how much you enjoyed this story.