Skip to main content

How to configure VPCS template preferences

VPCS (Virtual PC Simulator) is a lightweight tool in GNS3 that simulates a PC. Unlike routers or switches, VPCS only simulates a very simple virtual PC environment. It is used to test network connectivity.

Features

ComparisonVPCSReal Virtual Machine (VMware/QEMU)
Resource usageVery low (< 5 MB RAM)High (hundreds of MB to GB)
Startup speedSecondsMinutes
FunctionOnly IP/network toolsFull OS
When to useNetwork connectivity tests, protocol experimentsTests that need a full application or service

Create a Template

  1. Click the "VPCS" option to enter.

    Enter VPCS
  2. Click the + button at the top right to add a new template.

    Click add
  3. Enter the Template Name, then click "Add Template" to finish.

    Configure template
  4. Click the three-dot button on the right to choose Delete or Edit.

    Action menu

VPCS Template Configuration Details

General Settings

FieldTypeRequiredUse
Template nameTextYesName of the template, shown in lists and when creating instances
Default name formatTextYesAuto-naming format for instances, e.g. {name}-{0}
Base script fileTextYesPath to the startup script. VPCS commands that run automatically at startup
SymbolText + buttonYesIcon shown on the topology
TagsChip inputNoTags for sorting/filtering
CategoryDropdownNoDevice category, decides position in the device panel
Console typeDropdownNoConsole type: telnet / ssh / none
Auto start consoleCheckboxNoWhen enabled, the console opens automatically when VPCS starts
General settings

Base Script File Details

The Base script file is the main configuration for VPCS. The script uses VPCS commands. Common commands:

VPCS CommandDescriptionExample
ip <address> <mask> <gateway>Set IP, mask, and gatewayip 192.168.1.10 255.255.255.0 192.168.1.1
dhcpGet IP through DHCPdhcp -6
ping <host>Ping testping 192.168.1.1
trace <host>Route tracetrace 8.8.8.8
show ipShow current IP configuration--
show arpShow ARP table--
saveSave configuration to startup-config--

Example Base Script:

# VPCS startup script
ip 192.168.1.10 255.255.255.0 192.168.1.1
# or use DHCP
# dhcp -6

After VPCS starts, it runs the script commands one by one. The network is configured automatically. No manual input is needed.