LibreChat/docs/deployment/azure-terraform.md
Fuegovic bce4f41fae
🪪mkdocs: social cards (#1428)
* mkdocs plugins: add plugin for social cards and plugin that allow to exclude a folder

* docs: fix hyperlinks

* mkdocs: social cards (descriptions) for 'contributions' and 'deployment' guides

* mkdocs: social cards (descriptions) for all 'index.md'

* mkdocs: social cards (descriptions) for 'features' and 'plugins'

* mkdocs: social cards (descriptions) for 'general_info'

* mkdocs: social cards (descriptions) for 'configuration'

* mkdocs: social cards (descriptions) for 'installation'

* mkdocs: minor fixes

* update librechat.svg

* update how_to_contribute.md

add reference to the official GitHub documentation
2023-12-28 17:10:06 -05:00

35 lines
1.7 KiB
Markdown

---
title: ⚡ Azure
description: How to deploy LibreChat in Azure using Terraform.
weight: -6
---
# Azure deployment
There are different ways of how a deployment can be done in Azure.
One way is to use Terraform to setup all the necessary ressources automatically, here is an [example setup](https://github.com/thunderbug1/LibreChatAzureDeployment) with the setup instructions, which sets up all the necessary services.
## Prerequisites
You must have an existing Azure subscription for this to work.
## Steps
1. **Clone the [LibreChatAzureDeployment repository](https://github.com/thunderbug1/LibreChatAzureDeployment).**
2. **Open in VS-Code Devcontainer.**
3. **[Optional] Configure Deployment:**
* Edit `terraform.tfvars` to customize your deployment.
* You can for example set the `MONGO_URI` which is the connection string to your MongoDB. A fast and simple solution for that is a free cloud instance, like setting up an [Atlas Instance](https://github.com/danny-avila/LibreChat/blob/main/docs/install/mongodb.md). By default a CosmosDB instance is set up automatically.
4. **Azure Login:** Open the Terminal inside of VS-Code, and run the command `az login`.
5. **Terraform Initialization:** In the Terminal inside of VS-Code, run the command `terraform init`.
6. **Apply Terraform Configuration:** In the Terminal inside of VS-Code, run the command `terraform apply`.
7. **Open LibreChat:** After finishing, terraform shows the outputs in the terminal. Open the Url of "libre_chat_url" (it might take some minutes until everything has booted)
## Teardown
To tear down your Azure resources, run the command `terraform destroy` in the Terminal inside of VS-Code.