Knowledge

How to install Buddy Enterprise on Amazon EC2

This tutorial will show you how to configure an EC2 instance on Amazon and use it to host Buddy Enterprise installation.

Launch new EC2 server

Create a new EC2 instance on AWS with these settings:

  • Search Buddy Enterprise in Community AMIs
  • 20 GB of space
  • 4 GB RAM

If you haven't configured EC2 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.

Configuring EC2 instance
Configuring EC2 instance

Set up Buddy on EC2

Connect to your EC2 instance with SSH and follow the instructions below.

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.

NOTES:

  • 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 EC2 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 EC2

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

  1. Go to the list of instances on AWS and click the Security Group of the image with your Buddy Enterprise installation (you might want to scroll the screen to the right to reach it)
  2. Click ActionsEdit inbound rules
  3. Add the three ports set on Buddy:

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

Choose the Custom TCP 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 TCP rules and enter the ports manually.

  1. Save changes when ready
Setting up ports on EC2
Setting up ports on EC2

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 the EC2:

  1. Copy the public address of the EC2 instance with the installation
  2. If Buddy Enterprise 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 EC2 instance
Updating Buddy address with IP of EC2 instance

Set up your first workspace

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

Installation summary with workspace IP
Installation summary with workspace IP

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:

Buddy workspace
Buddy workspace

Congratulations!

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

Download Buddy Enterprise
esc

Sign up for free

No setup fees. No requirements. No obligation.

or sign up with