Azure

This tutorial shows how to configure a virtual machine on Azure and use it to host Buddy On-Premises.

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

Read this tutorial to learn how to configure an Azure VM.

If you’re planning to run heavy workloads on your instance, we recommend assigning at least 8GB of RAM. Read more about system requirements of Buddy On-Premises.

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 && sudo buddy install
$

In the installation process, you must choose a port for Git SSH connections. Remember the port you used - you need it to complete the configuration.

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

  1. Go to the VM with your Buddy Enterprise installation and click the Public IP address setting → Associated to… → Network security group… → Inbound security rules
  1. Add new rules with the ports used by Buddy:

    • HTTP80
    • HTTPS443
    • Custom – the Git SSH port you defined during the installation.

If you changed the default HTTP and HTTPS ports, add two more Custom TCP Rules and enter the ports manually.

  1. Save the changes.

Setting up ports on Azure \#2Setting up ports on Azure \#2

Update IP address of Buddy On-Premises

Update the address of your Buddy On-Premises installation so that it points to the Azure VM:

  1. Copy the public address of the Azure VM.
  2. Stop Buddy:
sudo buddy stop
$
  1. Enter configuration:
sudo buddy configure
$
  1. Go to option 4. IP & ports.
  2. Paste the IP address of the instance.
  3. Hit Enter to skip port configuration and restart Buddy to apply changes.

Setting up a workspace

  1. Use the updated URL to access Buddy On-Premises.*.

Installation summary with workspace IPInstallation summary with workspace IP

By default, Buddy On-Premises uses a self-signed SSL certificate. Because of that, you can get a security warning from your browser when you access the instance for the first time. There’s nothing to worry about! You can safely open the address.

  1. Provide the details of your first workspace.

Congratulations!

You have successfully installed and configured Buddy on your own server. Check out the Quickstart section for tips on getting started.