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

# Azure

> Deploy Gorbit on Azure Virtual Machines

<Steps>
  <Step title="Create a VM instance">
    Create a VM instance with the appropriate resources. For this guide,
    we will use the recommended `Standard_D4s_v3` instance.

    <Note>
      Read our [Resourcing guide](/deployment/getting_started/resourcing) for more details.
    </Note>

    * Give your instance a descriptive name like `gorbit-prod`
    * Select the `Ubuntu Server 20.04 LTS` image
    * Select the `Standard_D4s_v3` size
    * Select `Allow selected ports` and check `HTTPS (443)` in the *Inbound port rules* section
    * Configure storage following the Resourcing Guide

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/setup_guides/azure/create-vm.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=37e43f48d38bc5bfa2b1639277aad959" alt="Create VM Instance" width="5108" height="2474" data-path="assets/deployment/setup_guides/azure/create-vm.png" />

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/setup_guides/azure/create-vm-2.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=dc0909bf86002b19b100cec27589e80a" alt="Instance Settings" width="5108" height="2474" data-path="assets/deployment/setup_guides/azure/create-vm-2.png" />

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/setup_guides/azure/create-vm-3.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=6e3a850363ea5010d0ed1f936253c4b0" alt="Network Settings" width="5108" height="2474" data-path="assets/deployment/setup_guides/azure/create-vm-3.png" />
  </Step>

  <Step title="Create the instance">
    Click **Create** and then view your instance details.

    <Tip>
      Save the **Public IP address** of the instance!
    </Tip>

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/setup_guides/azure/instance-ip.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=c236f8852aef1f334835d6471382cd46" alt="Azure Public IP Address" width="2234" height="859" data-path="assets/deployment/setup_guides/azure/instance-ip.png" />
  </Step>

  <Step title="Point domain to the instance">
    <Note>
      If you don't have a domain, buy one from a DNS provider like [GoDaddy](https://www.godaddy.com/)
      or just skip HTTPS for now.
    </Note>

    To point our domain to the new instance, we need to add an `A` and `CNAME` record to our DNS provider.

    The `A` record should be the subdomain that you would like to use for the Gorbit instance like `prod`.

    The `CNAME` record should be the same name with the `www.` in front resulting in `www.prod` pointing to the full
    domain like `prod.gorbit.app`.

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/arecord.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=47b4684bb43f896b37e60dca9050b4a4" alt="DNS A Record Configuration" width="1597" height="605" data-path="assets/deployment/arecord.png" />

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/cname.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=53720dcb702e3a9ca0b51a1d6405006f" alt="DNS CNAME Record Configuration" width="1610" height="409" data-path="assets/deployment/cname.png" />
  </Step>

  <Step title="Install Gorbit requirements">
    Gorbit requires `git`, `docker`, and `docker compose`.

    To install these on Ubuntu Server 20.04 LTS, run the following:

    ```bash theme={null}
    sudo apt-get update
    sudo apt-get install -y ca-certificates curl

    sudo install -m 0755 -d /etc/apt/keyrings
    sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
    sudo chmod a+r /etc/apt/keyrings/docker.asc

    echo \
      "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
      $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
      sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

    sudo apt-get update
    sudo apt-get install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin git
    ```
  </Step>

  <InstallGorbit />
</Steps>

## Next Steps

<CardGroup cols={2}>
  <Card title="Configure Authentication" icon="shield-check" href="/deployment/authentication/basic">
    Set up authentication for your Gorbit deployment with OAuth, OIDC, or SAML.
  </Card>

  <Card title="More Gorbit Configuration Options" icon="gear" href="/deployment/configuration/configuration">
    Learn about all available configuration options for your Gorbit deployment.
  </Card>
</CardGroup>
