Azure
This tutorial shows how to configure a virtual machine on Azure and use it to host Buddy self-hosted.
Launching a new Azure VM
Create a new VM with these settings:
- Ubuntu 16.04 or newer
- 30 GB of disk space
- 4 GB RAM
Installing Docker Engine & Docker Compose
Buddy requires the Docker Engine and Docker Compose to run. Connect to your Azure VM and follow the installation instructions:
Installing Buddy
Connect to the VM and start installation
Connect to the Azure VM using SSH and run this command to download the Docker image and install Buddy:
curl -sSL https://get.buddy.works | sh && buddy install
$
HOME
directory. You can change the storage path for databases, repositories, and settings using the CLI.
Configuring the ports on Azure
During the installation, you must provide a new port for Git SSH, as the default port 22
is reserved by Azure. You must open the port you chose for Git SSH along with HTTP and HTTPS ports for incoming traffic.
- Go to the VM with your Buddy Enterprise installation and click the Public IP address setting → Associated to… → Network security group… → Inbound security rules
Add new rules with the ports used by Buddy:
- HTTP –
80
- HTTPS –
443
- Custom – the Git SSH port you defined during the installation.
- HTTP –
- Save the changes.
Image loading...Setting up ports on Azure \#2
Updating the IP address of Buddy Self-Hosted
Update the address of your Buddy self-hosted installation so that it points to the Azure VM:
- Copy the public address of the Azure VM.
- Stop Buddy:
buddy stop
$
- Enter configuration:
buddy configure
$
- Go to option
4. IP & ports
. - Paste the IP address of the instance.
- Hit Enter to skip port configuration and restart Buddy to apply changes.
Setting up your workspace
- Use the updated URL to access Buddy self-hosted.*.
Image loading...Installation summary with workspace IP
- Provide the details of your first workspace.
Sep 24, 2024