For the complete documentation index, see llms.txt. This page is also available as Markdown.

Configuring VLANs

Step-by-step instructions for creating VLAN-tagged external networks in VergeOS, including host-level and tenant configurations.

Prerequisites

Host Level Configuration

Before configuring VLANs, ensure that switchports are configured appropriately so that physical VergeOS nodes have access to the desired VLAN(s).

Tenant Configuration

For VLAN configuration within a tenant, Virtual Switch Ports must first be configured to provide external layer 2 access to the tenant.

Configuration Steps

Creating a VLAN Network

  1. Select Networks > + New External from the top menu

  2. Configure Basic Settings:

    • Enter a descriptive Name for the network

      • Use naming that indicates VLAN purpose and/or ID

    • Select vLan in the Layer 2 Type dropdown

    • Enter the appropriate Layer 2 ID

  3. Set Network Interface:

    • Select the appropriate physical network from Interface Network list

    Network Selection

    For Host Networks:

    • Must select a physical network where the VLAN enters the VergeOS environment

    • Physical networks typically created during install with "Switch" appended to name

    • Example: "External1 Switch"

    For Tenants:

    • Select "Physical"

  4. Configure Additional Settings:

    • Set IP Address Type to None

    • Leave other fields at default settings unless specific configuration needed

  5. Complete Configuration:

    • Click Submit to create the VLAN network

    • Verify network dashboard appears with Status: Running

Using the VLAN Network

Best Practices

  • Use descriptive names that help identify VLAN purpose

  • Document VLAN IDs and their intended use

  • Verify physical switch configuration matches VergeOS VLAN settings

  • Test connectivity after configuration

Troubleshooting

If the VLAN network does not show as running:

  1. Verify physical switch configuration

  2. Check VLAN ID matches physical network configuration

  3. Confirm Interface Network selection is correct

  4. Review network logs for any error messages

Last updated

Was this helpful?