Page MenuHomeVyOS Platform

dhcp-relay doesn't need multiple interfaces
Open, Requires assessmentPublicBUG


The configuration of dhcp-relay expects multiple interface names to be listed. This is not required, doesn't work as specified in the documentation, and gives misleading error messages.

Specification of multiple interfaces causes isc-dhcp-relay to listen for DHCP client broadcast requests on those interfaces and has nothing to do with where those broadcasts are then sent.

When specifying a single interface, commit gives an error message:

user@router# commit
[ service dhcp-relay ]
WARNING: At least two interfaces are required for DHCP relay
to work

Work to be done:


Difficulty level
Easy (less than an hour)
Why the issue appeared?
Will be filled on close
Is it a breaking change?
Unspecified (possibly destroys the router)

Event Timeline

I've created a PR in the vyos/vyos-documentation repo for the documentation fix:

I've created a PR in the vyos/vyos-1x repy for the config verification fix:

Unknown Object (User) added subscribers: c-po, dmbaturin, Unknown Object (User).May 9 2020, 10:13 AM

@dmbaturin @c-po
Not sure why did we merge these PRs. The isc-dhcp-relay does require at least two interfaces to work. This was discussed in details in T1276 and T2408.
As result the latest documentation is inaccurate what could make users confused.

Can you double check it?

Unknown Object (User) claimed this task.May 9 2020, 10:15 AM