Skip to content

Update to VLAN product docs #5663

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
13 changes: 0 additions & 13 deletions docs/guides/platform/vlan/_index.md

This file was deleted.

4 changes: 0 additions & 4 deletions docs/guides/platform/vlan/feature.svg

This file was deleted.

147 changes: 0 additions & 147 deletions docs/guides/platform/vlan/getting-started-with-vlans/index.md

This file was deleted.

42 changes: 35 additions & 7 deletions docs/products/networking/vlans/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -9,23 +9,30 @@ tab_group_main:
weight: 10
cascade:
date: 2020-10-22
product_description: "Linode’s VLANs (Virtual Local Area Networks) feature allows you to create private L2 networks in the cloud where Linodes can communicate privately and securely. Two or more Linodes connected via the VLAN can see each other as if they were directly connected to the same physical Ethernet network."
modified: 2022-07-28
product_description: "Fully isolated virtual local area networks that enable private communication between cloud-based resources"
modified: 2022-08-23
aliases: ['/guides/platform/vlan/']
---

**VLANs** are private *virtual local area networks* that are available at no additional cost to Linode users in select data centers. They operate on [layer 2](https://en.wikipedia.org/wiki/OSI_model#Layer_2:_Data_Link_Layer) of the OSI networking model and are entirely isolated from other networks. VLANs are a key part of enabling private and secure communication between Compute Instances on Linode's cloud platform. They function like a virtual network switch, which effectively means all Compute Instances connected to the same VLAN can communicate with each other like they were directly connected to the same physical Ethernet network. Devices outside the network cannot see any traffic within the private network.

## Features

### Secure and Private Communication
### Private Communication Between Compute Instances

Create a private L2 network and attach your Linodes to it for secure and private communication in the cloud. Two or more Linodes connected via the Private VLAN can see each other as if they were directly connected to the same physical Ethernet network. Devices outside of the network cannot see any traffic within the private network.
A VLAN creates a truly private network and communication is isolated to just the Compute Instances belonging to the same VLAN. No other Compute Instances on other VLANs or within the same data center can see this private traffic. This goes beyond Linode's [Private IP](/docs/guides/managing-ip-addresses/#types-of-ip-addresses) feature, which can be accessed by any resource in the same data center.

### Simple Configuration

Use the Cloud Manager to create a VLAN and attach Linode's to it in just a few clicks. Create up to 10 VLANs per data center, and apply up to 3 VLANs to a single Linode. For more fine-grained control, use the Linode APIv4 or Linode CLI.
Use the Cloud Manager to create a VLAN and assign Compute Instances. Create up to 10 VLANs per data center and assign each Compute Instance to up to 3 VLANs.

### Reduce Network Transfer Costs

Private network transfer is free. Any communication between Linodes over the private VLAN does not count against your [monthly network transfer usage](/docs/guides/network-transfer/).
Private network transfer is free. Any communication between Compute Instances over a VLAN does not count against the account's monthly [network transfer allowance](/docs/guides/network-transfer/).

### Part of a Flexible Custom VPC Solution

Since VLANs operate on layer 2 of the OSI networking stack, you can use is as part of a custom VPC solution, which typically operates on layer 3. VLAN users can implement their own firewall policies, routing, and security systems to build out their VPC.

## Availability

Expand All @@ -47,4 +54,25 @@ Private network transfer is free. Any communication between Linodes over the pri

VLANs are free to use. Communication across your private network does not count against your [monthly network transfer usage](/docs/guides/network-transfer/).

{{< content "vlans-limitations-shortguide" >}}
## Technical Specifications

- Fully isolated private networking for Cloud-based resources
- Operates on [Layer 2](https://en.wikipedia.org/wiki/OSI_model#Layer_2:_Data_link_layer) of the OSI model (the data link layer) and, as such, can be more flexible than Layer 3 based VPC (Virtual Private Cloud) solutions
- Supports all logical Ethernet features, such as L2 broadcast and L2 multicast
- Supports any [Layer 3](https://en.wikipedia.org/wiki/OSI_model#Layer_3:_Network_layer) protocol, including IP (Internet Protocol)
- User assignable IPv4 addresses
- Each account can maintain up to 10 VLANs per region
- Each Compute Instance can belong to up to 3 VLANs
- Network transfer over a VLAN does not count towards your account's [network transfer allowance](/docs/guides/network-transfer/)

## Additional Limits and Considerations

- **VLANs are region-specific.** Once created, a VLAN can only be attached to other Linodes within the same data center.

- **VLANs cannot be manually renamed by the user.** If a VLAN's label must be changed, a new VLAN can be created and all required Linodes can be attached to that new VLAN.

- **VLANs cannot be manually deleted by the user.** There is no need to manually delete a VLAN. If a VLAN is no longer needed, simply detach it from all Linodes. After this, it will automatically be deleted within a short timeframe.

- **Network Helper is required for automatic configuration.** If [Network Helper](/docs/guides/network-helper/) has been disabled, the Linode will not *automatically* be able to communicate over the VLAN’s private network. In this case, advanced users can manually adjust their Linode’s internal network configuration files with the appropriate settings for their VLAN. See [Manually configuring a VLAN on a Linode](/docs/products/networking/vlans/guides/manually-configuring-a-vlan/) for instructions.

- **The Public Internet must always use the eth0 network interface.** While VLANs themselves can function without issue on the `eth0` interface, the public internet on Linode will not be networked correctly on other interfaces.
Loading