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

# euca-install-image(1)

Bundle, upload and register an image into the cloud

## NAME

euca-install-image - Bundle, upload and register an image into the cloud

## SYNOPSIS

euca-install-image **-n** NAME \[--description DESCRIPTION\]

- \[--max-pending-parts MAX\_PENDING\_PARTS\]

  \[--virtualization-type {paravirtual,hvm}\] \[--platform windows\] \[--ec2-url EC2\_URL\] **-i** FILE \[-p PREFIX\] \[-d DIR\] **-r** {i386,x86\_64,armhf,ppc,ppc64,ppc64le} \[-k FILE\] \[-c FILE\] \[--ec2cert FILE\] \[-u ACCOUNT\] \[--kernel IMAGE\] \[--ramdisk IMAGE\] \[--bootstrap-url BOOTSTRAP\_URL\] \[-B VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,...\] \[--productcodes CODE1,CODE2,...\] \[--image-size IMAGE\_SIZE\] **-b** BUCKET\[/PREFIX\] \[--acl {public-read,aws-exec-read,ec2-bundle-read}\] \[--upload-policy POLICY \| **--upload-policy-file** FILE\] \[--upload-policy-signature SIGNATURE\] \[--location LOCATION\] \[--retry\] \[--progress \| **--no-progress\]** \[--show-empty-fields\] \[-U URL\] \[--region USER@REGION\] \[-I KEY\_ID\] \[-S KEY\] \[--security-token TOKEN\] \[--debug\] \[--debugger\] \[--version\] \[-h\]

## DESCRIPTION

Bundle, upload and register an image into the cloud

### optional arguments:

- **-n** NAME, **--name** NAME

  name of the new image (required)

- **--description** DESCRIPTION

  description of the new image

- **--max-pending-parts** MAX\_PENDING\_PARTS

  pause the bundling process when more than this number of parts are waiting to be uploaded (default: 2)

- **--virtualization-type** {paravirtual,hvm}

  virtualization type for the new image

- **--platform** windows

  \[Privileged\] the new image's platform (windows)

- **--ec2-url** EC2\_URL

  compute service endpoint URL

- **-i** FILE, **--image** FILE

  file containing the image to bundle (required)

- **-p** PREFIX, **--prefix** PREFIX

  the file name prefix to give the bundle's files (required when bundling stdin; otherwise defaults to the image's file name)

- **-d** DIR, **--destination** DIR

  location to place the bundle's files (default: dir named by TMPDIR, TEMP, or TMP environment variables, or otherwise */var/tmp*)

- **-r** {i386,x86\_64,armhf,ppc,ppc64,ppc64le}, **--arch** {i386,x86\_64,armhf,ppc,ppc64,ppc64le}

  the image's architecture (required)

- **-k** FILE, **--privatekey** FILE

  file containing your private key to sign the bundle's manifest with. If one is not available the bundle will not be signed.

- **-c** FILE, **--cert** FILE

  file containing your X.509 certificate. If one is not available it will not be possible to unbundle the bundle without cloud administrator assistance.

- **--ec2cert** FILE

  file containing the cloud's X.509 certificate. If one is not available locally it must be available from the bootstrap service.

- **-u** ACCOUNT, **--user** ACCOUNT

  your account ID

- **--kernel** IMAGE

  ID of the kernel image to associate with this machine image

- **--ramdisk** IMAGE

  ID of the ramdisk image to associate with this machine image

- **--bootstrap-url** BOOTSTRAP\_URL

  \[Eucalyptus only\] bootstrap service endpoint URL (used for obtaining **--ec2cert** automatically

- **-B** VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,..., **--block-device-mappings** VIRTUAL1=DEVICE1,VIRTUAL2=DEVICE2,...

  block device mapping scheme with which to launch instances of this machine image

- **--productcodes** CODE1,CODE2,...

  comma-separated list of product codes for the image

- **--image-size** IMAGE\_SIZE

  the image's size (required when bundling stdin)

- **-b** BUCKET\[/PREFIX\], **--bucket** BUCKET\[/PREFIX\]

  bucket to upload the bundle to (required)

- **--acl** {public-read,aws-exec-read,ec2-bundle-read}

  canned ACL policy to apply to the bundle (default: aws-exec-read)

- **--upload-policy** POLICY

  upload policy to use for authorization

- **--upload-policy-file** FILE

  file containing an upload policy to use for authorization

- **--upload-policy-signature** SIGNATURE

  signature for the upload policy (required when an 'upload policy is used)

- **--location** LOCATION

  location constraint of the destination bucket (default: inferred from s3-location-constraint in configuration, or otherwise none)

- **--retry**

  retry failed uploads up to 5 times

- **--progress**

  show progress (the default when run interactively)

- **--no-progress**

  do not show progress (the default when run noninteractively)

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

  show empty values as "(nil)"

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

  object storage 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