Linux

This tutorial shows how to install Buddy On-Premises on a Linux distribution.

Installing Docker Engine & Docker Compose

Buddy requires Docker Engine and Docker Compose to run. Connect to your server and follow the installation instructions:

Installing Buddy

Connect to the server and start installation

Connect to the server using SSH and run this command to download the Docker image and install Buddy:

curl -sSL https://get.buddy.works | sh && sudo buddy install
$

By default, Buddy uses ports 80, 443, and 22 for communication. If these ports are not available, the installer asks to provide alternative ports.

If you're connecting to the server through a proxy, add the HTTP_PROXY environment variable on the Linux server. Run this command:

export HTTP_PROXY="http://proxyIp:proxyPort"
$

Setting up a workspace

  1. Use the URL provided in the summary 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.

Congratulations!

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