---
name: "euca-run-instances"
section: "1"
platform: "linux"
package: "euca2ools"
version: "3.3.1-2"
release: "Debian 10 (Buster)"
platforms: ["linux"]
url: "https://new.carta.tech/euca-run-instances"
---

# euca-run-instances(1)

Launch instances of a machine image

## NAME

euca-run-instances - Launch instances of a machine image

## SYNOPSIS

euca-run-instances \[-n MIN\[-MAX\]\] \[-g GROUP\] \[-k KEYPAIR\]

- \[-d DATA \| **--user-data-force** DATA \| **-f** FILE\]

  \[--addressing {public,private}\] \[-t INSTANCETYPE\] \[-z ZONE\] \[--kernel KERNEL\] \[--ramdisk RAMDISK\] \[-b DEVICE=MAPPED\] \[-m\] \[--disable-api-termination\] \[--instance-initiated-shutdown-behavior {stop,terminate}\] \[--placement-group PLGROUP\] \[--tenancy {default,dedicated}\] \[--client-token TOKEN\] \[-s SUBNET\] \[--associate-public-ip-address ASSOCIATE\_PUBLIC\_IP\_ADDRESS\] \[--private-ip-address ADDRESS\] \[--secondary-address ADDRESS \| **--secondary-count** COUNT\] \[-a INTERFACE\] \[-p IPROFILE\] \[--ebs-optimized\] \[--show-empty-fields\] \[-U URL\] \[--region USER@REGION\] \[-I KEY\_ID\] \[-S KEY\] \[--security-token TOKEN\] \[--debug\] \[--debugger\] \[--version\] \[-h\] IMAGE

## DESCRIPTION

Launch instances of a machine image

### positional arguments:

- IMAGE

  ID of the image to instantiate (required)

### optional arguments:

- **-n** MIN\[-MAX\], **--instance-count** MIN\[-MAX\]

  number of instances to launch. If this number of instances cannot be launched, no instances will launch. If specified as a range (min-max), the server will attempt to launch the maximum number, but no fewer than the minimum number.

- **-g** GROUP, **--group** GROUP

  security group(s) in which to launch the instances

- **-k** KEYPAIR, **--key** KEYPAIR

  name of the key pair to use

- **-d** DATA, **--user-data** DATA

  user data to make available to instances in this reservation

- **--user-data-force** DATA

  same as **-d**/--user-data, but without checking if a file by that name exists first

- **-f** FILE, **--user-data-file** FILE

  file containing user data to make available to the instances in this reservation

- **--addressing** {public,private}

  \[Eucalyptus only, non-VPC only\] addressing scheme to launch the instance with. Use "private" to run an instance with no public address.

- **-t** INSTANCETYPE, **--instance-type** INSTANCETYPE

  type of instance to launch

**-z** ZONE, **--availability-zone** ZONE

- **--kernel** KERNEL

  ID of the kernel to launch the instance(s) with

- **--ramdisk** RAMDISK

  ID of the ramdisk to launch the instance(s) with

- **-b** DEVICE=MAPPED, **--block-device-mapping** DEVICE=MAPPED

  define a block device mapping for the instances, in the form DEVICE=MAPPED, where "MAPPED" is "none", "ephemeral(0-3)", or "\[SNAPID\]:\[GiB\]:\[true\|false\]:\[standard\|VOLTYPE\[:IOPS\]\]"

- **-m**, **--monitor**

  enable detailed monitoring for the instance(s)

- **--disable-api-termination**

  prevent API users from terminating the instance(s)

- **--instance-initiated-shutdown-behavior** {stop,terminate}

  whether to "stop" (default) or terminate EBS instances when they shut down

- **--placement-group** PLGROUP

  name of a placement group to launch into

- **--tenancy** {default,dedicated}

  \[VPC only\] "dedicated" to run on single-tenant hardware

- **--client-token** TOKEN

  unique identifier to ensure request idempotency

- **-s** SUBNET, **--subnet** SUBNET

  \[VPC only\] subnet to create the instance's network interface in

- **--associate-public-ip-address** ASSOCIATE\_PUBLIC\_IP\_ADDRESS

  \[VPC only\] assign a public address to the instance's network interface

- **--private-ip-address** ADDRESS

  \[VPC only\] assign a specific primary private IP address to an instance's interface

- **--secondary-address** ADDRESS, **--secondary-private-ip-address** ADDRESS

  \[VPC only\] assign a specific secondary private IP address to an instance's network interface. Use this option multiple times to add additional addresses.

- **--secondary-count** COUNT, **--secondary-private-ip-address-count** COUNT

  \[VPC only\] automatically assign a specific number of secondary private IP addresses to an instance's network interface

- **-a** INTERFACE, **--network-interface** INTERFACE

  \[VPC only\] add a network interface to the new instance. If the interface already exists, supply its ID and a numeric index for it, separated by ":", in the form "eni-NNNNNNNN:INDEX". To create a new interface, supply a numeric index and subnet ID for it, along with (in order) an optional description, a primary private IP address, a list of security group IDs to associate with the interface, whether to delete the interface upon instance termination ("true" or "false"), a number of secondary private IP addresses to create automatically, and a list of secondary private IP addresses to assign to the interface, separated by ":", in the form ":INDEX:SUBNET:\[DESCRIPT ION\]:\[PRIV\_IP\]:\[GROUP1,GROUP2,...\]:\[true\|false\]:\[SEC\_I P\_COUNT\|:SEC\_IP1,SEC\_IP2,...\]". You cannot specify both of the latter two. This option may be used multiple times. Each adds another network interface.

- **-p** IPROFILE, **--iam-profile** IPROFILE

  name or ARN of the IAM instance profile to associate with the new instance(s)

- **--ebs-optimized**

  optimize the new instance(s) for EBS I/O

- **--show-empty-fields**

  show empty values as "(nil)"

- **-U** URL, **--url** URL

  compute service endpoint URL

- **--region** USER@REGION

  region and/or user names to search when looking up config file data

**-I** KEY\_ID, **--access-key-id** KEY\_ID

**-S** KEY, **--secret-key** KEY

**--security-token** TOKEN

- **--debug**

  show debugging output

- **--debugger**

  launch interactive debugger on error

- **--version**

  show the program's version and exit

- **-h**, **--help**

  show this help message and exit