Add L2 tenant network creation details and removal process#411
Open
jasnoyaeger wants to merge 2 commits intomainfrom
Open
Add L2 tenant network creation details and removal process#411jasnoyaeger wants to merge 2 commits intomainfrom
jasnoyaeger wants to merge 2 commits intomainfrom
Conversation
Document what gets created when sharing a Layer 2 network to a tenant (NIC, Physical network, External network) and add step-by-step removal instructions validated on a live system. Key findings from testing: - NIC is auto-removed when L2 network is disabled/deleted from host - Tenant-side networks (External, Physical) must be manually cleaned up - External network must be deleted before Physical (dependency order) - Navigation path corrected to Network > Layer2 Networks in left sidebar Closes #405 Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
jcampbellvergeio
suggested changes
Mar 13, 2026
- Add L2 External network prerequisite in root system with link - Fix Network dropdown guidance (select external L2 only, not all networks) - Update warning to reference Tenant L2 Networks instead of Virtual Switch Ports - Correct network status from Running to Stopped after auto-creation - Fix naming examples (e.g., "External VLAN 400", "Physical - External VLAN 400") - Update VM NIC attachment to External network only (not Physical) - Replace VM network placement with gateway instructions linking to Internal Networks - Remove firewall rules references (not applicable to L2 networks) - Fix tenant navigation paths to Networks → List - Change "Click" to "Double-Click" for opening tenant in removal steps - Add "External VLAN Network in Root" best practice - Add prerequisite note at top of Configuration Steps section Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
jcampbellvergeio
suggested changes
Mar 16, 2026
| 2. **Physical Network** - Backend network infrastructure. Appears in the tenant's network list with the name of the network you're passing through, prepended by "**Physical -**" | ||
| 1. **NIC Interface on the Tenant Node** - A new virtual NIC is added to the tenant node, connected to the specified VLAN | ||
| 2. **Physical Network** - Backend network infrastructure that the NIC plugs into. Appears in the tenant's network list with the name of the network you're passing through, prepended by "**Physical -**" | ||
| 3. **External Network** - Plugs into the Physical network above. Appears in the tenant's network list with the name of the network you're passing through |
Contributor
There was a problem hiding this comment.
Can you add to this: The External Network will not have a VLAN tag on it. The Interface is already tagged for this VLAN. Leave this network untagged. (i have received multiple tickets where the customer confused this and thought it needed a tag and tagged it)
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Summary
Closes #405
Validation Results
Tested the full create → verify → disable → delete → cleanup lifecycle on a live VergeOS 26.1.3 system with a root host and a single-node tenant.
Creation
Physical - <network-name>appeared (Stopped)<network-name>appeared (Stopped)Removal
Key Findings That Informed Doc Changes
Test plan
mkdocs serverenders the updated page without errors🤖 Generated with Claude Code