---
layout: integration
title: Self-host Appwrite on Azure
description: Run self-hosted Appwrite on Azure Virtual Machines, or on Azure Kubernetes Service with the Helm chart
date: 2026-11-06
featured: false
isPartner: false
isNew: true
cover: /images/integrations/self-hosted-azure/cover.avif
category: self-hosting
product:
    vendor: Microsoft Azure
    description: "Microsoft Azure is Microsoft's cloud computing platform, with services such as Virtual Machines and Azure Kubernetes Service."
platform:
    - 'Self-hosted'
---

[Microsoft Azure](https://azure.microsoft.com) is Microsoft's cloud computing platform. It offers Linux and Windows virtual machines, managed Kubernetes with Azure Kubernetes Service (AKS), and managed data services such as Azure Database for PostgreSQL and Azure Cache for Redis.

# How does the integration work?

Appwrite runs on any Linux server that supports Docker, so an Azure Virtual Machine is the simplest way to self-host it on Azure. You create the VM, open the ports Appwrite needs, and run the Appwrite Docker installer, which walks you through a web-based setup wizard.

If you already run Kubernetes on Azure, install Appwrite on AKS with the official Appwrite Helm chart instead. Its Azure example connects Appwrite to Azure Database for PostgreSQL, Azure Cache for Redis, and Azure Files.

# How to implement

To self-host Appwrite on an Azure Virtual Machine, there are several steps you must complete:

## Step 1: Create a virtual machine

In the Azure portal, create a Linux virtual machine with at least 2 vCPUs and 4 GB of RAM, the minimum Appwrite needs. Appwrite also expects 2 GB of swap memory.

## Step 2: Open the required ports

In the VM's network security group, allow inbound HTTP (80) and HTTPS (443) traffic, and SSH (22) from your IP address only. Allow port 20080 while the setup wizard runs, and remove that rule after installation.

## Step 3: Install Docker and run the Appwrite installer

Connect to the VM over SSH and [install Docker Engine](https://docs.docker.com/engine/install/) with Docker Compose version 2. Then run the macOS and Linux [installation command](/docs/advanced/self-hosting/installation#installation-commands) from the installation guide, which always installs the latest release.

## Step 4: Complete the setup wizard

Open `http://<VM_PUBLIC_IP>:20080` in your browser. Set the hostname your instance will use, choose a database (PostgreSQL is the default), save the generated secret key somewhere safe, create your account, and click **Install**. When the installation finishes, open your hostname to reach the Appwrite Console.

# Run Appwrite on Azure Kubernetes Service

To run Appwrite on AKS, install the [Appwrite Helm chart](/docs/advanced/self-hosting/platforms/kubernetes) and start from its [`azure.yaml` example](https://github.com/appwrite/helm-chart/blob/main/examples/azure.yaml), which connects Appwrite to Azure Database for PostgreSQL, Azure Cache for Redis, and Azure Files.

# Read more about Azure and self-hosted Appwrite

If you would like to learn more about running Appwrite on Azure, we have some resources that you should visit:

- [Azure deployment guide](/docs/advanced/self-hosting/platforms/azure)
- [Self-hosting installation guide](/docs/advanced/self-hosting/installation)
- [Production guide](/docs/advanced/self-hosting/production)
- [Azure Virtual Machines documentation](https://learn.microsoft.com/en-us/azure/virtual-machines/)