> For the complete documentation index, see [llms.txt](https://docs.vergeos-demo.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.vergeos-demo.com/run-the-platform/networking/create-vlan.md).

# Configuring VLANs

## Prerequisites

{% hint style="info" %}
**Host Level Configuration**

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

{% hint style="info" %}
**Tenant Configuration**

For VLAN configuration within a tenant, [Virtual Switch Ports](/knowledge-base/tenants/provide-layer2-to-tenant.md) must first be configured to provide external layer 2 access to the tenant.
{% endhint %}

## 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

   <div data-gb-custom-block data-tag="hint" data-style="info" class="hint hint-info"><p><strong>Network Selection</strong></p><p><strong>For Host Networks:</strong></p><ul><li>Must select a physical network where the VLAN enters the VergeOS environment</li><li>Physical networks typically created during install with "Switch" appended to name</li><li>Example: "External1 Switch"</li></ul><p><strong>For Tenants:</strong></p><ul><li>Select "Physical"</li></ul></div>
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

{% hint style="success" %}
**VM Configuration**

The newly created VLAN network can be selected on VM NICs to attach workloads to the associated VLAN(s).
{% endhint %}

## 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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.vergeos-demo.com/run-the-platform/networking/create-vlan.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.