---
title: "createLaunchConfiguration"
slug: "cli-vautoscaling-launchconfiguration-createlaunchconfiguration"
tags: ["Auto Scaling", "VPC"]
updated: 2026-10-08T04:56:25Z
published: 2026-10-08T04:56:25Z
canonical: "cli.ncloud-docs.com/cli-vautoscaling-launchconfiguration-createlaunchconfiguration"
---

> ## Documentation Index
> Fetch the complete documentation index at: https://cli.ncloud-docs.com/llms.txt
> Use this file to discover all available pages before exploring further.

# createLaunchConfiguration

Available in VPC

Create a Launch Configuration.

## Syntax

The `createLaunchConfiguration` syntax is as follows:

```
./ncloud vautoscaling createLaunchConfiguration \
    --serverImageNo <image-no> | --memberServerImageInstanceNo <member-image-no> | --serverImageProductCode <image-product-code> \
    --serverSpecNo <spec-no>] | --serverSpecCode <spec-code> | --serverProductCode <product-code>] \
    [--isEncryptedVolume <true|false>] \
    [--initScriptNo <init-script-no>] \
    [--launchConfigurationName <launch-configuration-name>] \
    [--loginKeyName <login-key-name>] \
    [--regionCode <KR|SGN|JPN>] \
    [--output <json|xml>]
```

## Options

This section describes the options available when running `createLaunchConfiguration`.

### Required options

The following options are required for `createLaunchConfiguration`.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `--serverImageNo` | String | Conditional | Server image number - Enter this when creating a server with a new server image (scale-out) (KVM, RHV, XEN). - At least one among `serverImageNo`, `memberServerImageInstanceNo`, or `serverImageProductCode` must be entered. - If multiple values are entered, they are applied in the order of `serverImageNo`, `memberServerImageInstanceNo`, `serverImageProductCode`. - See [getServerImageList](/docs/en/cli-vserver-serverimage-getServerImageList). |
| `--memberServerImageInstanceNo` | String | Conditional | Server image Instance number - Enter when creating a server using a user-created server image (scale-out). - At least one among `serverImageNo`, `memberServerImageInstanceNo`, or `serverImageProductCode` must be entered. - If multiple values are entered, they are applied in the order of `serverImageNo`, `memberServerImageInstanceNo`, `serverImageProductCode`. - See [getMemberServerImageInstanceList](/docs/en/cli-vserver-serverimage-getmemberserverimageinstancelist). |
| `--serverImageProductCode` | String | Conditional | Server image product code - Enter this when creating a server with a new server image (scale-out) (RHV, XEN). - At least one among `serverImageNo`, `memberServerImageInstanceNo`, or `serverImageProductCode` must be entered. - If multiple values are entered, they are applied in the order of `serverImageNo`, `memberServerImageInstanceNo`, `serverImageProductCode`. - See [getServerImageProductList](/docs/en/cli-vserver-server-common-getserverimageproductlist). |
| `--serverSpecNo` | String | Conditional | Server spec number - At least one among `serverSpecNo`, `serverSpecCode`, or `serverProductCode` must be entered. - If multiple values are entered, they are applied in the order of `serverSpecNo`, `serverSpecCode`, `serverProductCode`. - When using `serverImageProductCode`, configures the server spec. - See [getServerSpecList](/docs/en/cli-vserver-server-common-getserverspeclist). |
| `--serverSpecCode` | String | Conditional | Server spec code - At least one among `serverSpecNo`, `serverSpecCode`, or `serverProductCode` must be entered. - If multiple values are entered, they are applied in the order of `serverSpecNo`, `serverSpecCode`, `serverProductCode`. - See [getServerSpecList](/docs/en/cli-vserver-server-common-getserverspeclist). |
| `--serverProductCode` | String | Conditional | Server product code - At least one among `serverSpecNo`, `serverSpecCode`, or `serverProductCode` must be entered. - If multiple values are entered, they are applied in the order of `serverSpecNo`, `serverSpecCode`, `serverProductCode`. - See [getServerProductList](/docs/en/cli-vserver-server-common-getserverproductlist). |

### Optional options

These are the optional options for `createLaunchConfiguration`. Options that are not specified will use their default values.

| Options | Type | Required | Description |
| --- | --- | --- | --- |
| `--isEncryptedVolume` | Boolean | Optional | Whether to encrypt the default block storage volume - `true` \| `false` (default) - `true`: Encrypted - `false`: Not encrypted - Can only be set on RHV server images. |
| `--initScriptNo` | String | Optional | Init script number - Run user-set Init script on first boot. - See [getInitScriptList](/docs/en/cli-vserver-initscript-getinitscriptlist). |
| `--launchConfigurationName` | String | Optional | Launch configuration name - Enter 1-255 characters, including lowercase English letters, numbers, and special character `-`. - The string must start with a lowercase English letter and end with a lowercase English letter or number. - Auto-generated on no input. |
| `--loginKeyName` | String | Optional | Authentication key name - Default: Most recently created authentication key. - See [getLoginKeyList](/docs/en/cli-vserver-server-loginkey-getloginkeylist). |

### Common options

For information on options commonly used in the `vautoscaling` command, see [Auto Scaling (VPC) options](/docs/en/cli-vautoscaling#%EC%98%B5%EC%85%98).

## Examples

If the request to create a launch configuration is successful, the configuration details and creation status of the launch configuration are returned.

### Command

The command example is as follows:

```
./ncloud vautoscaling createLaunchConfiguration \
    --serverImageNo 123456789 \
    --serverSpecCode s2-g3a \
    --launchConfigurationName launch-config-01 \
    --loginKeyName test-key \
    --regionCode KR \
    --output json
```

### Output

The output example is as follows:

```
{
  "createLaunchConfigurationResponse": {
    "totalRows": 1,
    "launchConfigurationList": [
      {
        "regionCode": "KR",
        "launchConfigurationNo": "12345",
        "launchConfigurationName": "launch-config-01",
        "serverImageProductCode": "SW.VSVR.OS.LNX64.ROCKY.09.G003",
        "serverProductCode": "SVR.VSVR.AMD.STAND.C002.M008.G003",
        "loginKeyName": "test-key",
        "createDate": "2026-08-06T16:51:17+0900",
        "launchConfigurationStatus": {
          "code": "CREAT",
          "codeName": "CREATED"
        },
        "initScriptNo": "",
        "isEncryptedVolume": false,
        "serverImageNo": "123456789",
        "osInformation": "rocky-9.8",
        "serverSpecNo": "1234",
        "serverSpecCode": "s2-g3a",
        "serverSpecDescription": "vCPU 2EA, Memory 8GB"
      }
    ],
    "requestId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
    "returnCode": "0",
    "returnMessage": "success"
  }
}
```