Knowledge

How to install Buddy GO on DigitalOcean

This tutorial will show you how to configure a DigitalOcean droplet and use it to host your Buddy GO installation.

Launch new DO droplet

Create a new DO droplet with these settings:

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

NOTES

  • 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.
  • We do not recommend using one-click apps because of possible Docker version compatibility problems.

    Creating a new droplet
    Creating a new droplet

Set up Buddy on DO droplet

Connect to your droplet 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://p80.pool.sks-keyservers.net:80 --recv-keys 58118E89F3A912897C070ADBF76221572C52609D
echo "deb https://apt.dockerproject.org/repo 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 https://github.com/docker/compose/releases/download/1.8.0/docker-compose-`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

To install Buddy GO, 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.

Buddy GO Installation Process
Buddy GO Installation Process

NOTES:

  • Buddy GO uses ports 80, 443 and 22 on the installation server. You will be asked for an alternative port if one of the ports is unavailable.

  • 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 your workspace

When the installation is over, Buddy GO will launch and the URL to your instance will appear.

Copy and paste the link to your browser to begin.

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

Congratulations!

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
Twitter.com/BuddyGit

Join our development automation movement!

Download On-Premises Installation