Migrating an Assigned LAN to LAGG

Only unassigned physical ports can be added to a LAGG, so to move an assigned LAN interface to a LAGG requires some shuffling around.

In this example, the LAN of a device (igc0) will be moved into a LAGG with another port on the same device (igc1).


It is best to perform this change from an interface that is not involved, such as a secondary LAN, DMZ, OPT port, perhaps WAN or VPN. Though if the switch is properly configured there should be no loss of connectivity, at least with LACP. Other modes may vary.


The switch must be properly configured to accommodate the LAGG. This typically means configuring an LACP group and setting ports to use that group. The NICs involved, in this example igc1 and igc0, should be connected to properly configured ports on the switch before starting.

Migrate LAN to a LAGG

  • Ensure the second NIC for the LAGG is not assigned (e.g. igc1 mapped to LAN2, OPTx, etc.)

    • Check Interfaces > Assignments and remove its entry if present.

  • Create a new LAGG including only the second NIC

    • Navigate to Interfaces > Assignments on the LAGG tab

    • Click fa-plus to create a new LAGG

    • Click to select the NIC to use with this LAGG (igc1)

    • Select the proper LAGG protocol, such as LACP

    • Enter a description

    • Click Save

  • Navigate to Interfaces > Assignments, change the assignment of LAN to the newly created LAGG interface (lagg0)

  • Click Save

  • Navigate back to the LAGG tab

  • Click fa-pencil to edit the LAGG

  • Ctrl-click to add in the port that was formerly assigned to LAN (igc0) so that both NICs are selected

  • Click Save

Now both igc1 and igc0 are members of a LAGG and that LAGG is the LAN interface with all of the existing configuration in place.


If any VLANs were in use directly on the interfaces involved, migrate them as follows:

  • Add new VLAN tags using the LAGG interface as the parent (Interfaces > Assignments, VLAN tab)

  • Fix the assignments to use the LAGG versions of the tags (Interfaces > Assignments)

  • Remove the old tags from the physical interface(s) (Interfaces > Assignments, VLAN tab)


Do not edit the existing tags and change the parent interface

Changing the parent in place will cause problems with the interface assignments. Always create new tags, switch the assignments, then remove the old tags.