---
title: Project Harmonia
description: Learn how you can run your applications in the cloud with Project Harmonia
keywords: run, cloud, docker desktop, resources
sitemap: false
params:
  sidebar:
    group: Products
aliases:
- /run-cloud/
---

{{% restricted title="Private preview" %}}
Project Harmonia is in Private preview.
{{% /restricted %}}

Project Harmonia brings the power of the cloud to your local development workflow. You can now run your applications in the cloud whilst continuing to use your existing tools and workflows and without worrying about local resource limitations. Project Harmonia also lets you share previews of your cloud-based applications for real-time feedback. 

## Set up 

To get started with Project Harmonia, you need to:

- Have a Docker account that's part of a Docker organization
- Email `run.cloud@docker.com` to get help with onboarding

## Quickstart

You can use Project Harmonia from the Docker Desktop Dashboard or from the CLI. 

This guide introduces you to essential commands and steps for creating, managing, and sharing a cloud engine. 

### Step one: Create a cloud engine

{{< tabs group="method" >}}
{{< tab name="Docker Desktop">}}

1. In the Docker Desktop Dashboard, navigate to the **Project Harmonia** tab. 
2. In the top right-hand corner, select **Create Cloud Engine**.
3. Fill out the creation form:
   - Enter `cloudengine` as the name
   - Choose an organization to associate the cloud engine with
   - Select the engine size and architecture

   Note that the **Switch Docker Context to use remote engine** is selected by default. The automatically switches you to your new cloud engine once it has been created. 
4. Select **Create**.

To verify creation, check the context switcher in the top-left corner of the Docker Desktop Dashboard; it should display `cloudengine`. You’re now ready to use it.

{{< /tab >}}
{{< tab name="CLI">}}

Run the following command: 

```console
$ docker harmonia engine create cloudengine --type "standard-amd64"  --use
```

This creates an engine called `cloudengine` and:
- Immediately switches you to the new cloud engine with the `--use` flag.
- Sets the engine size to standard and the engine's CPU architecture to amd64 with the `--type` flag. 

Project Harmonia supports the following values for `--type`:
- `standard-arm64`
- `standard-amd64` (default)
- `large-arm64`
- `large-amd64`
- `aiml-amd64`

Standard size engines have 2 CPU cores and 4GB RAM, large and AI/ML engines have 4 CPU cores and 8GB RAM.

To verify you're using the newly created cloud engine, run:

```console
$ docker context inspect
```

You should see the following:

```text
[
    {
        "Name": "cloudengine2",
...
```

{{< /tab >}}
{{< /tabs >}}

### Step two: Run and remove containers with the newly created cloud engine 

1.  Run an Nginx container in the cloud engine:
    ```console
    $ docker run -d --name cloudnginx -p 8080:80 nginx
    ```
    This maps the container's port `80` to the host's port `8080`. If port `8080` is already in use on your host, you can specify a different port.
2.  View the Nginx welcome page. Navigate to [`http://localhost:8080/`](http://localhost:8080/).
3.  Verify the running container:
    -   In the **Containers** tab in the Docker Desktop Dashboard, you should see your Nginx container listed.
    -   Alternatively, list all running containers in the cloud engine via the terminal:
        ```console
        $ docker ps
        ```
4.  Shut down the container:
    ```console
    $ docker kill cloudnginx
    ```

Running a container with a cloud engine is just as straightforward as running it locally.

### Step three: Create and switch to a new cloud engine

{{< tabs group="method" >}}
{{< tab name="Docker Desktop">}}

1. Create a new cloud engine:
   - Enter `cloudengine2` as the name
   - Choose an organization to associate the cloud engine with
   - Select the **Standard** engine size with the **AMD-64** architecture
   In the **Project Harmonia** view you should now see both `cloudengine` and `cloudengine2`.