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.