> ## 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.

# GCP

> Deploy Gorbit on GCP Compute Engine

**Make sure your Google Cloud Platform account has the necessary permissions to create a VM instance.**

<Steps>
  <Step title="Create a VM instance">
    Create a VM instance with the appropriate resources. For this guide,
    we will use the recommended `e2-standard-4` 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 `Debian GNU/Linux 12` boot disk
    * Select the `e2-standard-4` machine type
    * Select `Allow HTTPS traffic` in the **Firewall** section
    * Configure storage following the Resourcing Guide

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/setup_guides/gcp/CreateVmInstance.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=0087de95575cad35868d47267b04f0ef" alt="Create VM Instance" width="1043" height="314" data-path="assets/deployment/setup_guides/gcp/CreateVmInstance.png" />

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/setup_guides/gcp/Instance.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=9f58815cd69a05c0001176915be91f67" alt="Instance Settings" width="744" height="947" data-path="assets/deployment/setup_guides/gcp/Instance.png" />

    <img className="rounded-image" src="https://mintcdn.com/gorbit/qYeWoSrsnkRPFQDm/assets/deployment/setup_guides/gcp/Firewall.png?fit=max&auto=format&n=qYeWoSrsnkRPFQDm&q=85&s=94fd10f17481f79992b05f9264606bb5" alt="Firewall Settings" width="822" height="437" data-path="assets/deployment/setup_guides/gcp/Firewall.png" />
  </Step>

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

    <Tip>
      Save the **External IP** of the instance!
    </Tip>
  </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 Debian GNU/Linux 12, run the following:

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

    sudo install -m 0755 -d /etc/apt/keyrings
    curl -fsSL https://download.docker.com/linux/debian/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
    sudo chmod a+r /etc/apt/keyrings/docker.gpg
    echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/debian $(lsb_release -cs) stable" | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

    sudo apt update
    sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin
    ```

    If using CentOS, Red Hat Linux, or similar, run the following:

    ```bash theme={null}
    sudo yum update -y

    sudo yum install docker -y
    sudo service docker start

    sudo curl -L https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m) -o /usr/local/bin/docker-compose
    sudo chmod +x /usr/local/bin/docker-compose

    sudo yum install 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>