Amazon Elastic Compute Cloud
User Guide for Windows Instances

Installing the Latest Version of EC2Config

By default, the EC2Config service is included in AMIs for Windows Server 2003 through Windows Server 2012 R2. When the EC2Config service is updated, new Windows AMIs include the latest version of the service. However, you need to update your own Windows AMIs and instances with the latest version of EC2Config.


EC2Launch replaces EC2Config on Windows Server 2016 AMIs. For more information, see Configuring a Windows Instance Using EC2Launch.

For information about how to receive notifications for EC2Config updates, see Subscribing to EC2Config Service Notifications. For information about the changes in each version, see the EC2Config Version History.

Before You Begin

  • Verify that you have .NET framework 3.5 SP1 or greater.

  • By default, Setup replaces your settings files with default settings files during installation and restarts the EC2Config service when the installation is completed. If you changed EC2Config service settings, copy the config.xml file from the %Program Files%\Amazon\Ec2ConfigService\Settings directory. After you update the EC2Config service, you can restore this file to retain your configuration changes.

  • If you have a version of EC2Config that is earlier than version 2.1.19 and you are trying to upgrade up to 2.2.12, you must first update to version 2.1.19, and then update to the current version. To update to version 2.1.19, download, unzip the file, and then run EC2Install.exe. Note this issue has been fixed in version 2.3.313.

To verify the version of EC2Config included with your Windows AMI

  1. Launch an instance from your AMI and connect to it.

  2. In Control Panel, select Programs and Features.

  3. In the list of installed programs, look for Ec2ConfigService. Its version number appears in the Version column.

To install the latest version of EC2Config on your instance using Run Command

You can remotely install the latest version of the EC2Config service by using EC2 Run Command. For more information, see Updating the EC2Config Service Using Systems Manager Run Command.

To install the latest version of EC2Config on your instance manually

  1. Download and unzip the EC2Config installer.

  2. Run EC2Install.exe. For a complete list of options, run EC2Install with the /? option. By default, setup displays prompts. To run the command with no prompts, use the /quiet option.


    To keep the custom settings from the config.xml file that you saved, run EC2Install with the /norestart option, restore your settings, and then restart the EC2Config service manually.

  3. If you are running EC2Config version 4.0 or later, you must restart the SSM Agent on the instance from the Microsoft Services snap-in.