This tutorial shows how to configure an EC2 Amazon instance and use it to host Buddy On-Premises.

All commands listed in the article must be run as root.

Launching a new EC2 server

Create a new EC2 instance on AWS with these settings:

  • Find Buddy On-Premises in Community AMIs
  • 30 GB of disk space
  • 4 GB RAM

Read this tutorial to learn how to configure EC2.

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 Buddy

Connect to EC2 and start installation

Connect to your EC2 instance using SSH and run this command to download the Docker image and install Buddy:

curl -sSL | sh && 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 the ports on EC2

During the installation, you must provide a new port for Git SSH, as the default port 22 is reserved by EC2. You must open the port you chose for Git SSH along with HTTP and HTTPS ports for incoming traffic.

Follow these steps:

  1. Go to the list of instances on AWS and click the Security Group of the image with your Buddy On-Premises installation.
  2. Click ActionsEdit inbound rules.
  3. Add the three ports set on Buddy:

    • HTTP80
    • HTTPS443
    • Custom TCP Rule – 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.

Updating the IP address of Buddy On-Premises

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

  1. Copy the public address of the EC2 instance.
  2. Stop Buddy:
buddy stop
  1. Enter configuration:
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 your 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.


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

Last modified on September 8, 2022

Get Started

Sign up for free and deploy your project in less than 10 minutes.