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

# Azure Chatwoot deployment guide

> Deploy Chatwoot on a single VM in Azure

This guide will deploy chatwoot on a single VM in Azure. For a cloud native deployment, use our [helm charts](https://github.com/chatwoot/charts) with Azure Kubernetes Service(AKS).

<Note>
  This guide is a work in progress and your mileage may vary.
</Note>

## Create a Virtual Machine

1. Login to the Azure portal and choose Virtual Machines.
2. Select create a VM from scratch.
3. In the Basics tab, create a subscription and a new resource group.
4. Name the virtual machine as `chatwoot` and select your preferred region.
5. Select `Ubuntu 20.04 LTS - Gen2` as the image.
6. For instance size, we recommend the type `Standard_D4s_v3`(4vCPU, 16GB RAM).
7. Under authentication, leave the defaults and create a new key pair if needed.
8. Allow HTTP, HTTPS and SSH under inbound port rules.
9. Click next and leave the defaults for Disks, Networking, Management, Advanced and Tags section.
10. Select `Review + create` to spin up the VM.

<img src="https://mintcdn.com/chatwoot-447c5a93/0ZKii1AePO4f9gzo/self-hosted/images/azure.png?fit=max&auto=format&n=0ZKii1AePO4f9gzo&q=85&s=91b0a35578680e5667c918b76b700f9d" alt="azure-create-vm" width="969" height="1397" data-path="self-hosted/images/azure.png" />

## Install Chatwoot

1. SSH into the instance created from your local machine or create a bastion in azure to ssh via the browser.
2. Follow the linux VM instructions at [https://www.chatwoot.com/docs/self-hosted/deployment/linux-vm](https://www.chatwoot.com/docs/self-hosted/deployment/linux-vm).
3. Woot! Woot! Your Chatwoot Instance is ready and can be accessed at `http://<your-instance-ip>:3000`. Or if you completed the domain setup during the installation, chatwoot should be available at `https://<your-domain>`.

<Note>
  Browser access via port 3000 will only work if enabled under inbound rules.
</Note>

## Configure Chatwoot

1. Follow the Chatwoot docs to configure your domain, email and other parameters you need.
   [https://www.chatwoot.com/docs/self-hosted/deployment/linux-vm#configure-the-required-environment-variables](https://www.chatwoot.com/docs/self-hosted/deployment/linux-vm#configure-the-required-environment-variables)
