How to install Buddy GO on Azure

This tutorial will show you how to configure a virtual machine on Azure and use it to host Buddy GO installation.

Launch new Azure VM

Create a new VM with these settings:

  • Ubuntu 16.04
  • 20 GB of space
  • 4 GB RAM

If you haven't configured virtual machine on Azure before, this tutorial will walk you through the process.

NOTE: If you're planning to run heavy workloads on your instance we recommend assigning at least 8GB of RAM. You can read more about the system requirements of Buddy GO here.

Configuring new Azure VM
Configuring new Azure VM

Set up Buddy on Azure

Connect to your Azure VM with SSH and follow the instructions below.

Install Docker Engine

Run the following commands in the listed sequence:

sudo apt-get update
sudo apt-get install apt-transport-https ca-certificates
sudo apt-key adv --keyserver hkp:// --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
echo "deb ubuntu-xenial main" > /etc/apt/sources.list.d/docker.list
sudo apt-get update
sudo apt-get install docker-engine

Install Docker Compose

  1. Once Docker Engine is installed, download the most recent Docker Compose using curl from the Docker Compose release page.

If you get a “Permission denied” error, your /usr/local/bin directory probably isn’t writable and you’ll need to install Compose as the superuser. Run sudo -i, then the two commands below, then exit.

The following is an example command illustrating the format:

curl -L`uname -s`-`uname -m` > /usr/local/bin/docker-compose

After executing the curl command apply executable permissions to the binary:

chmod +x /usr/local/bin/docker-compose
Docker Compose install curl
Docker Compose install curl

Install Buddy GO

Run the following in the terminal:

    curl -sSL | sh && sudo buddy install

This command will download 2GB of Docker image. If you are having any trouble with the download, please contact us for assistance.

Buddy GO Installation Process
Buddy GO Installation Process


  • During installation you will be asked to provide a port for Git SSH connections. Make sure to remember it as you'll have to open it on the VM in the next step.

  • By default Buddy installs in your HOME directory. You can change the storage path for databases, repositories, and settings in the configuration settings

Set up ports on Azure

While installing Buddy you will be asked to provide a new Git SSH port (the default 22 is reserved by Azure). This port must be manually opened on the VM for the incoming traffic, along with HTTP and HTTPS:

  1. Go to the VM with your Buddy GO installation and click the Public IP address setting → Associated to... → Network security group... → Inbound security rules

    Setting up ports on Azure #1
    Setting up ports on Azure #1
  2. Add new rules with the three ports set on Buddy

    • HTTP (80)
    • HTTPS (443)
    • Custom (the SSH port that you provided on installation)

    Choose the Custom rule and enter the value of the SSH port that you set on Buddy. The same applies for HTTP and HTTPS: if you've changed their default value on Buddy, add Custom rules and enter the ports manually.

  3. Save changes when ready

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

Update IP address of Buddy GO

With the ports configured all that remains is updating the address of your Buddy GO installation so that it points to Azure:

  1. Copy the public address of the VM with the installation
  2. If Buddy GO is running, halt it using

    buddy stop
  3. Go to the configuration settings by entering

    buddy configure
  4. Go to IP & ports
  5. Paste the IP address of the instance
  6. Hit enter to skip port configuration and restart Buddy to apply changes
Updating Buddy address with IP of Azure VM
Updating Buddy address with IP of Azure VM

Set up your workspace

Use the the updated URL to begin using Buddy on-premises.

Installation summary with workspace IP
Installation summary with workspace IP

Buddy GO uses a self-signed certificate for SSL. You may see a warning about this upon accessing your workspace for the first time. There's nothing to worry about: you can safely proceed to the website.

Provide the details of your first workspace:

Buddy workspace
Buddy workspace


You've just successfully installed and configured Buddy GO on your own server. Make sure to check out our guides for inspiration and some good practice that will help you get started.

Good luck in your ventures!
The Buddy Team

Download On-Premises Installation

Sign up for free

No setup fees. No requirements. No obligation.

or sign up with