Skip to main content
1

Create a VM instance

Create a VM instance with the appropriate resources. For this guide, we will use the recommended Standard_D4s_v3 instance.
Read our Resourcing guide for more details.
  • 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
Create VM InstanceInstance SettingsNetwork Settings
2

Create the instance

Click Create and then view your instance details.
Save the Public IP address of the instance!
Azure Public IP Address
3

Point domain to the instance

If you don’t have a domain, buy one from a DNS provider like GoDaddy or just skip HTTPS for now.
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.DNS A Record ConfigurationDNS CNAME Record Configuration
4

Install Gorbit requirements

Gorbit requires git, docker, and docker compose.To install these on Ubuntu Server 20.04 LTS, run the following:
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

​
Next Steps

Configure Authentication

Set up authentication for your Gorbit deployment with OAuth, OIDC, or SAML.

More Gorbit Configuration Options

Learn about all available configuration options for your Gorbit deployment.