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

# Azure AirysChat deployment guide

> Deploy AirysChat on a single VM in Azure

This guide will deploy airyschat on a single VM in Azure. For a cloud native deployment, use our [helm charts](https://github.com/airyschat/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 `airyschat` 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/airys/1FWn-RJM-8Ky_sbQ/self-hosted/images/azure.png?fit=max&auto=format&n=1FWn-RJM-8Ky_sbQ&q=85&s=10f1b6368b54f903dec6b1f938631bf8" alt="azure-create-vm" width="969" height="1397" data-path="self-hosted/images/azure.png" />

## Install AirysChat

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.airyschat.com/docs/self-hosted/deployment/linux-vm](https://www.airyschat.com/docs/self-hosted/deployment/linux-vm).
3. Woot! Woot! Your AirysChat Instance is ready and can be accessed at `http://<your-instance-ip>:3000`. Or if you completed the domain setup during the installation, airyschat should be available at `https://<your-domain>`.

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

## Configure AirysChat

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