This tutorial will show you how to configure a virtual machine on Azure and use it to host a Buddy Enterprise installation.
Launch a new Azure VM
Create a new VM with these settings:
- Ubuntu 16.04
- 30 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 Enterprise here.
Install Docker Engine
Buddy requires the Docker Engine to run. SSH to your Azure VM and follow the Docker installation instructions at https://docs.docker.com/engine/installation/linux/ubuntu.
Install Docker Compose
With the Engine installed, you can install Docker Compose which is also required by Buddy: https://docs.docker.com/compose/install
Install Buddy Enterprise
Run the following in the terminal:
curl -sSL https://get.buddy.works | 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.
- 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]/on-premises/solving-problems/low-storage)
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:
- 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 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.
- Save changes when ready
Update IP address of Buddy Enterprise
With the ports configured all that remains is updating the address of your Buddy Enterprise installation so that it points to Azure:
- Copy the public address of the VM with the installation
- If Buddy Enterprise is running, halt it using
- Go to the configuration settings by entering
text buddy configure ```
- Go to
IP & ports
- Paste the IP address of the instance
- Hit enter to skip port configuration and restart Buddy to apply changes
Set up your workspace
Use the the updated URL to begin using Buddy on-premises.
Buddy Enterprise 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:
You’ve just successfully installed and configured Buddy Enterprise 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