Skip to content
Command line interface and Node module for managing ievms virtual machines
Branch: master
Clone or download
Fetching latest commit…
Cannot retrieve the latest commit at this time.
Type Name Latest commit message Commit time
Failed to load latest commit information.


Command line interface and Node module for managing ievms virtual machines.

NPM version


For ievms:

  • VirtualBox
  • Curl (Ubuntu: sudo apt-get install curl)
  • Linux Only: unar (Ubuntu: sudo apt-get install unar)

For iectrl:



$ sudo npm install -g iectrl


$ npm install iectrl


Command Line Interface

The iectrl command provides various sub-commands for manipulating one or many ievms virtual machines. The optional names argument may be a comma-separated (no spaces) list of virtual machine identifiers. The identifiers consist of a number representing a given version of IE, an OS name (WinXP/Vista/Win7/Win8), or an exact virtual machine name (IE6 - WinXP, IE7 - Vista). See iectrl <sub-command> --help for more information:

$ iectrl --help

  Usage: iectrl [options] [command]


    clean [names] restore virtual machines to the clean snapshot
    close [names] close all running IE processes in virtual machines
    install [options] [names] install virtual machines with ievms
    nuke [names] remove all traces of virtual machines
    list         list available virtual machines
    open [options] [names] [url] open a URL in IE
    rearm [options] [names] rearm virtual machines
    reinstall [options] [names] reinstall virtual machines
    restart [options] [names] restart virtual machines
    screenshot [names] [output] save screenshots for virtual machines
    shrink [options] [names] shrink disk usage for virtual machines
    start [options] [names] start virtual machines
    status [options] [names] report the status of one or more vms
    stop [options] [names] stop virtual machines
    uninstall [options] [names] uninstall virtual machines
    uploaded [names] report the last time the VM was uploaded to


    -h, --help     output usage information
    -V, --version  output the version number

Node Module

See the annotated source or karma-ievms for usage examples.


Install all WinXP virtual machines from ievms (IE6 - WinXP, IE7 - WinXP, IE8 - WinXP):

$ iectrl install WinXP

Reinstall all Win7 virtual machines, plus IE 6 (IE6 - WinXP):

$ iectrl reinstall 6,Win7

Shrink the disk usage for IE10 by removing the .ova file used during install:

$ iectrl shrink 10

Open IE version 6 and 8 and navigate to auto-starting the virtual machines if necessary:

$ iectrl open -s 6,8

Take a screenshot of the IE7 - Vista virtual machine, saving it to ./shots/IE7 - Vista.png:

$ iectrl screenshot 'IE7 - Vista' ./shots

Close all open IE browser windows:

$ iectrl close
You can’t perform that action at this time.