Network Topology

The network topology view provides an interactive visualization of your virtual machines and their network connections.

Overview

The topology view renders an interactive graph showing:

• Virtual machines as nodes
• Networks as connection points
• Links between VMs and networks

Node Types

Virtual Machines

Networks

Orange nodes represent virtual networks:

• NAT - Network with internet access
• Isolated - Private network for VM-to-VM communication

Routers

Blue nodes represent virtual routers or network-service VMs.

Interaction

Mouse Controls

Node Details

Double-click a node to view:

• VM name and state
• IP addresses
• CPU/Memory allocation
• Connected networks
• Action buttons (Start, Stop, Console)

Hover Information

Hover over any node to see:

• Quick status summary
• Network connections
• Resource usage

Layout

Auto-Layout

The topology arranges nodes automatically:

• Connected nodes cluster together
• Networks act as connection hubs
• Layout stabilizes after loading

Manual Arrangement

Drag nodes to create your preferred layout:

• Positions are preserved during session
• Reset layout with the refresh button

Network Configuration

Creating Networks

1. Click Create Network button
2. Enter network name
3. Select network type:
   • NAT (default)
   • Isolated
4. Configure IP range (optional)
5. Click Create

Network Types

Connecting VMs

When creating a VM, select networks to connect:

1. Primary network (first interface)
2. Additional networks (optional)

VMs can connect to multiple networks for complex topologies.

Example Topologies

Simple Server

[Internet] ── [NAT Network] ── [Web Server VM]

Client-Server Testing

[Client VM] ─┬─ [Test Network] ─┬─ [Server VM]
             │                   │
             └─── [NAT] ────────┘

Multi-Tier Application

[Load Balancer] ── [Frontend Network] ── [Web VMs (x3)]
                           │
                   [Backend Network]
                           │
                      [Database VM]

Filtering

Use the filter controls to:

• Show only running VMs
• Filter by network
• Search by name
• Show/hide networks

Export

Export the topology as JSON for documentation or tooling.

Automatic Updates

The topology updates automatically when:

• VM state changes (start/stop)
• New VM created
• Network modified
• Connection changed

The view polls for changes every 30 seconds or so, so updates appear without reloading the page.

Troubleshooting

Nodes Overlapping

Click the Reset Layout button to re-arrange the graph.

Missing Connections

Verify the VM has the expected virtual network interface and that the network is active.

Slow Performance

For large deployments (50+ VMs), consider:

• Filtering to relevant VMs
• Disabling animation
• Reducing update frequency