> Markdown version of [Azure](https://vaadin.com/docs/v24/hilla/lit/guides/production/cloud-providers/azure). Section index: [llms.txt](https://vaadin.com/docs/v24/hilla/llms.txt)

# Deploying a Hilla Application to Azure Cloud

This tutorial shows you how to deploy a Hilla application to Microsoft’s Azure cloud. Azure offers a 30-day free trial that includes 12 months of free commercial services. You can find details of their free and commercial services from the [Azure website](https://azure.microsoft.com/).

> **Note: Azure account required**
>
> To complete this tutorial, you need an Azure account. You can sign up at <https://signup.azure.com/>.

## <a id="step-1-install-the-azure-cli"></a>Step 1: Install the Azure CLI

You can find installation instructions for different platforms in the [Azure CLI documentation](https://docs.microsoft.com/en-us/cli/azure/?view=azure-cli-latest).

## <a id="step-2-download-a-starter-app"></a>Step 2: Download a Starter App

Download a minimal Hilla project and unpack the downloaded zip into a folder on your computer.

```terminal
npx @hilla/cli init --lit my-app
```

## <a id="step-3-add-the-azure-plugin"></a>Step 3: Add the Azure Plugin

Open your `pom.xml` file and add the following section in the `<plugins>` tag in the `<build>` section:

`pom.xml`

```xml
<plugin>
  <groupId>com.microsoft.azure</groupId>
  <artifactId>azure-webapp-maven-plugin</artifactId>
  <version>2.2.3</version>
</plugin>
```

## <a id="step-4-create-a-production-build"></a>Step 4: Create a Production Build

Open the project directory from a terminal window, and enter the following command to generate a `JAR` file of your application:

```terminal
mvn package -Pproduction
```

## <a id="step-5-configure-your-application"></a>Step 5: Configure Your Application

From the terminal window, enter the following command:

```terminal
mvn azure-webapp:config
```

This command authenticates you with Azure via the browser, assuming you aren’t already logged in with the Azure CLI. You are then prompted with certain options. You can select the following:

1. **\<create>** when asked to choose a Java SE Web App.

2. **Linux** when asked to choose an OS.

3. **Java** 11 for the Java version

4. **F1** for the pricingTier

5. Enter `Y` on your keyboard to confirm

[Image: Azure CLI choices]

## <a id="step-6-deploy-your-application"></a>Step 6: Deploy Your Application

Enter the following command to deploy your app:

```terminal
mvn azure-webapp:deploy
```

You might be required to authenticate again in the browser. Once authenticated, your application is deployed to Azure and you should see your application URL in the logs as in the following screenshot.

[Image: Azure CLI log]