---
title: Deploy Kaeso on Azure
description: "Run Kaeso on one Azure virtual machine from the Deploy to Azure button or the Azure CLI. The installer runs at first boot, and the setup link comes through Cloud Shell without SSH."
url: https://kaeso.app/articles/deploy-kaeso-on-azure
markdown: https://kaeso.app/articles/deploy-kaeso-on-azure.md
language: en
alternates:
  de: https://kaeso.app/de/articles/deploy-kaeso-on-azure.md
  zh-CN: https://kaeso.app/zh-CN/articles/deploy-kaeso-on-azure.md
published: 2026-11-11
authors:
  - Kaeso Team
tags:
  - self-hosting
  - azure
  - deployment
  - guide
image: https://kaeso.app/articles/deploy-kaeso-on-azure/cover.jpg
index: https://kaeso.app/llms.txt
---

# Deploy Kaeso on Azure

Run Kaeso on one Azure virtual machine from the Deploy to Azure button or the Azure CLI. The installer runs at first boot, and the setup link comes through Cloud Shell without SSH.

> Every page, article and docs page of Kaeso is listed in https://kaeso.app/llms.txt.

- Published: 11 November 2026
- Reading time: 3 min
- Author: Kaeso Team

Kaeso's Azure template is a quick server: the Compose package on one virtual machine, as on your own server, with Caddy for TLS, a bundled ClickHouse for request logs and the updater. It needs no domain of its own to start, since Azure gives the machine a DNS name and Caddy gets a certificate for it. The whole deployment takes about five minutes.

`deploy/azure/` in the repository holds the Azure Resource Manager template, and `createUiDefinition.json` beside it shapes the portal's form.

## What you get

- A virtual network with one subnet, and a network security group that lets in HTTP, HTTPS and HTTP/3 only, and SSH only from an address range you give.
- A static public address with a DNS name under `<region>.cloudapp.azure.com`.
- An Ubuntu 24.04 virtual machine with Trusted Launch, boot diagnostics and a 40 GB disk, `Standard_B2als_v2` with 2 vCPUs and 4 GB by default.
- A Custom Script extension that runs Kaeso's installer at the first boot: it installs Docker, writes the settings and starts the Compose package.

The template holds none of Kaeso's secrets. The installer generates the master key and the passwords on the server itself.

## Deploy with the button

1. Open [Deploy to Azure](https://portal.azure.com/#create/Microsoft.Template/uri/https%3A%2F%2Fraw.githubusercontent.com%2Flogicplanes%2Fkaeso%2Fprod%2Fdeploy%2Fazure%2Fquick-server.json/createUIFormUri/https%3A%2F%2Fraw.githubusercontent.com%2Flogicplanes%2Fkaeso%2Fprod%2Fdeploy%2Fazure%2FcreateUiDefinition.json) and sign in. The portal reads the template from the branch `prod`, which holds the latest release.
2. Choose a subscription, a new resource group and a region, and fill in the parameters below.
3. Create the deployment, and wait until it is complete. It finishes once the installer has.
4. Under the deployment's **Outputs**, copy `setupLink` and run it in [Azure Cloud Shell](https://shell.azure.com) or with the Azure CLI. It prints the one-time setup link without SSH. Open it to create the first user.
5. With a domain of your own, point its CNAME record at the `fqdn` output, or an A record at `publicIp`. Caddy keeps trying until the name resolves, then gets the certificate.

## Deploy with the Azure CLI

From a clone of the repository, create a resource group and deploy the template into it:

```bash
az group create --name kaeso --location westeurope
az deployment group create --resource-group kaeso \
  --template-file deploy/azure/quick-server.json \
  --parameters domain=kaeso.example.com \
  adminPasswordOrKey="$(cat ~/.ssh/id_ed25519.pub)" sshSourceAddress=203.0.113.0/24
```

The command prints the outputs once the deployment is complete. Run `setupLink` from them, as in step 4 above.

## Parameters

| Parameter | What it is |
| --- | --- |
| `domain` | The domain Kaeso answers on; empty uses the address's DNS name |
| `dnsLabel` | The address's DNS name under `<region>.cloudapp.azure.com`; empty makes one from the resource group |
| `kaesoVersion` | A release to install; empty installs the newest stable release |
| `vmSize`, `diskSizeGb`, `diskType` | `Standard_B2als_v2`, 40 GB and Standard SSD by default |
| `adminUsername`, `authenticationType`, `adminPasswordOrKey` | The server's administrator, with an SSH public key or a password |
| `sshSourceAddress` | An address range that may reach SSH; empty keeps port 22 closed |
| `location` | The region; the resource group's by default |

## Keep the master key

Kaeso encrypts provider keys with the master key in `/opt/kaeso/master-keys`, so a backup of the database can't be read without it. Keep a copy apart from your backups: run the `setupLink` output's command with `cat /opt/kaeso/master-keys` as its script to print it, and put it in a password manager.

## Update

Updates work as on any Compose install: from the console, automatically in a window you choose, or by hand. The template only creates the server; deploying it again doesn't update Kaeso.

## Good to know

- This is a quick server only. The repository has no template for Azure Container Apps with Azure Database for PostgreSQL and a managed cache yet.
- The sizes are x64. For an Arm64 size, deploy Ubuntu 24.04 for Arm64 and run the installer by hand.

## What was tested

The template passes Microsoft's ARM template test toolkit. It hasn't been deployed from an empty Azure account yet; the same installer has, on AWS and Google Cloud. If you deploy it, [tell us](https://kaeso.app/contact) how it went.

## Next steps

- [Azure in the docs](https://docs.kaeso.app/self-hosting/platforms/azure), with every parameter.
- [Upgrades](https://docs.kaeso.app/self-hosting/upgrades): how the updater installs new releases.
- [Where to run Kaeso](https://kaeso.app/articles/where-to-run-kaeso): how Azure compares with the other platforms.

By Kaeso Team

## More articles

- [Deploy Kaeso on AWS](https://kaeso.app/articles/deploy-kaeso-on-aws.md): Two CloudFormation templates run Kaeso on AWS. The quick server puts the Compose package on one Graviton instance in one click; the managed stack runs it on ECS Fargate with an Application Load Balancer, RDS and ElastiCache.
- [Deploy Kaeso on Google Cloud](https://kaeso.app/articles/deploy-kaeso-on-google-cloud.md): Two Terraform configurations run Kaeso on Google Cloud. The quick server puts the Compose package on one Compute Engine instance from Cloud Shell; the managed configuration runs it on Cloud Run with a load balancer, Cloud SQL and Memorystore.

[See all articles](https://kaeso.app/articles.md)

## Own the gateway. Own the record

```bash
curl -fsSL https://kaeso.app/install.sh | sh
```

[Install Kaeso](https://docs.kaeso.app/self-hosting/installation) · [Open the live demo](https://demo.kaeso.app)
