---
title: "Create Azure cloudSwXtch template"
slug: "create-azure-cloudswxtch-template"
updated: 2025-12-19T20:02:03Z
published: 2025-12-19T20:02:03Z
canonical: "docs.swxtch.io/create-azure-cloudswxtch-template"
---

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

# Create an Azure cloudSwXtch Template

**WHAT TO EXPECT**

The easiest way to deploy a cloudSwXtch instance in an Azure environment is through the template method. **The following process is a one-time task per version per subscription.** **In this section,** users will learn the template creation process in preparation for Azure cloudSwXtch installation.

### Template Creation

A cloudSwXtch template can be created by using the Azure Portal. This template can be used to deploy any number of cloudSwXtches. The template is not used during the creation of a cloudSwXtch via the Marketplace. The creation of the Template is a one-time task per cloudSwXtch version per subscription.

1. Log in to the Azure Portal. The user will need permissions to create and manage virtual machines:
  - virtual-machine-contributor
2. **Open Cloud Shell in Bash mode.**

![Azure_cloudSwXtch-cloudshell](https://cdn.document360.io/84c5db44-f675-4f33-a980-5d3fc63073ca/Images/Documentation/Azure_cloudSwXtch-cloudshell.png)

Use [this](https://learn.microsoft.com/en-us/azure/cloud-shell/quickstart) link for help with setting up the Cloud Shell.
3. **Enter** the following command to get to the proper resource group:

```shell
rg="<the-rg-here>"
```

Example below:

![](https://cdn.document360.io/84c5db44-f675-4f33-a980-5d3fc63073ca/Images/Documentation/image-1757009372498.png)
4. **Enter** the following command to clone the "cloudSwXth-AzureTemplates":

```shell
git clone https://github.com/swxtchio/cloudSwXtch-AzureTemplates
```

Example below:

![](https://cdn.document360.io/84c5db44-f675-4f33-a980-5d3fc63073ca/Images/Documentation/image-1757009515187.png)
5. **Change** directory to "cloudSwXtch-AzureTemplates".

```shell
cd cloudSwXtch-AzureTemplates
```

**If desired**, use the "ls" command to see what is in the directory. Example below:

![Azure_marketplace-template-json](https://cdn.document360.io/84c5db44-f675-4f33-a980-5d3fc63073ca/Images/Documentation/image-1757009996198.png)
6. **Create** "cloudSwxtch-from-mp-image" using the following command:

```shell
az ts create -n cloudSwxtch-from-mp-image -g $rg -v 1 -f MPTemplateVM.json --ui-form-definition MPTemplateUI.json
```

The output should look like the screenshot below:

![aztemp.PNG](https://cdn.document360.io/84c5db44-f675-4f33-a980-5d3fc63073ca/Images/Documentation/image-1757010056756.png)

NEXT STEP: Azure cloudSwXtch Installation

After completing template creation and [validating subnets](/v2/docs/validate-subnets-on-azure), continue on to the main [Azure cloudSwXtch Installation guide](/v2/docs/azure-cloudswxtch-installation).