Help us improve your experience.

Let us know what you think.

Do you have time for a two-minute survey?


username-include (DHCP Local Server)


Hierarchy Level


Configure the username that the router or switch passes to the external AAA server. You must include at least one of the optional statements for the username to be valid. If you do not configure a username, the router (or switch) accesses the local authentication service only and does not use external authentication services, such as RADIUS.

The following statements are not supported in the DHCPv6 hierarchy levels:

  • option-60

  • option-82

The following statements are supported in the DHCPv6 hierarchy levels only:

  • relay-agent-interface-id

  • relay-agent-remote-id

  • relay-agent-subscriber-id



Include the subscriber session VLAN tags in the username for interactions with an external authority. Both single-tagged and double-tagged VLANs are supported: The tags are added in the format outer-vlan-tag-inner-vlan-tag. The outer tag is always included; the inner tag is included for double-tagged VLANs.

Use this option instead of the interface-name option when the outer VLAN tag is unique across the system and you do not need the underlying physical interface name to be part of the format.

The remaining statements are explained separately. Search for a statement in CLI Explorer or click a linked statement in the Syntax section for details.

Required Privilege Level

system—To view this statement in the configuration.

system-control—To add this statement to the configuration.

Release Information

Statement introduced in Junos OS Release 9.1.

vlan-tags option added in Junos OS Release 18.3R1 on MX Series routers.