﻿---
title: Create a deployment
description: Let’s create a basic deployment. Elastic Cloud Hosted supports solutions and hardware profiles, which pre-configure the Elastic Stack components in your...
url: https://www.elastic.co/elastic/docs-builder/docs/2423/reference/ecctl/ecctl-example-create-deployment
---

# Create a deployment
Let’s create a basic deployment. Elastic Cloud Hosted supports [solutions](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2423/get-started) and [hardware profiles](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2423/deploy-manage/deploy/elastic-cloud/ec-change-hardware-profile), which pre-configure the Elastic Stack components in your deployment to best suit your particular use case. For this example, use Google Cloud Platform (GCP) to host the deployment in region `US Central 1 (Iowa)`. To know which deployment options are available by platform, see [available regions, deployment templates and instance configurations](https://docs-v3-preview.elastic.dev/elastic/docs-builder/docs/2423/reference/cloud-hosted/ec-regions-templates-instances).
Copy the following JSON payload and save it as file `create-deployment.json`.
```json
{
  "name": "My first ecctl deployment",
  "resources": {
    "elasticsearch": [
      {
        "region": "gcp-us-central1", 
        "ref_id": "main-elasticsearch",
        "plan": {
          "cluster_topology": [
            {
              "node_type": {
                "master": true,
                "data": true,
                "ingest": true,
                "ml": false
              },
              "instance_configuration_id": "gcp.data.highio.1", 
              "zone_count": 2, 
              "size": {
                "resource": "memory",
                "value": 2048 
              }
            }
          ],
          "elasticsearch": {
            "version": "7.6.0" 
          },
          "deployment_template": {
            "id": "gcp-io-optimized" 
          }
        }
      }
    ],
    "kibana": [
      {
        "region": "gcp-us-central1",
        "elasticsearch_cluster_ref_id": "main-elasticsearch",
        "ref_id": "main-kibana",
        "plan": {
          "cluster_topology": [
            {
              "instance_configuration_id": "gcp.kibana.1",
              "zone_count": 1, 
              "size": {
                "resource": "memory",
                "value": 1024 
              }
            }
          ],
          "kibana": {
            "version": "7.6.0" 
          }
        }
      }
    ],
    "apm": [
      {
        "region": "gcp-us-central1",
        "elasticsearch_cluster_ref_id": "main-elasticsearch",
        "ref_id": "main-apm",
        "plan": {
          "cluster_topology": [
            {
              "instance_configuration_id": "gcp.apm.1",
              "zone_count": 1, 
              "size": {
                "resource": "memory",
                "value": 512 
              }
            }
          ],
          "apm": {
            "version": "7.6.0" 
          }
        }
      }
    ]
  }
}
```

This JSON contains the settings for a highly available Elasticsearch cluster deployed across two availability zones, a single instance of Kibana, and a single APM server.
Run the [ecctl deployment create](https://www.elastic.co/elastic/docs-builder/docs/2423/reference/ecctl/ecctl_deployment_create) command with `create-deployment.json` as a parameter. For this and other commands, you can add an optional `--track` parameter to monitor the progress.
```sh
ecctl deployment create [--track] -f create-deployment.json
```

```sh
{
  "created": true,
  "id": "7229888e7bf8350c7e4d07d7374171c0",
  "name": "My first ecctl deployment",
  "resources": [
    {
      "cloud_id": "My_first_ecctl_deployment:dXMtY2VudHJhbDEuZ2NwLmZvdW5kaXQubm8kYjFlZWVjOGQ0YWVlNGY3ZDgxNTM2Zjc1ZjZhN2Y1MDgkM2ViZTAzNmI0NDhkNDc3Y2E2ZTJjZTQ5NmE4ZDQ5ODA=",
      "credentials": {
        "password": "REDACTED",
        "username": "elastic"
      },
      "id": "b1eeec8d4aee4f7d81536f75f6a7f508",
      "kind": "elasticsearch",
      "ref_id": "main-elasticsearch",
      "region": "gcp-us-central1"
    },
    {
      "elasticsearch_cluster_ref_id": "main-elasticsearch",
      "id": "3ebe036b448d477ca6e2ce496a8d4980",
      "kind": "kibana",
      "ref_id": "main-kibana",
      "region": "gcp-us-central1"
    },
    {
      "elasticsearch_cluster_ref_id": "main-elasticsearch",
      "id": "5a03472f6dfe4f17acbe62622823b9cb",
      "kind": "apm",
      "ref_id": "main-apm",
      "region": "gcp-us-central1",
      "secret_token": "zfufcfe15eCVJk78b5"
    }
  ]
}
```

The response indicates that the request was submitted successfully. It includes the `elastic` user password, which you can use to log in to Kibana or to access the Elasticsearch REST API. Make a note of the deployment ID, which you will use in the next example.