How to install Buddy Enterprise on Linux server

This guide shows how to install Buddy on a Linux distribution. If you are using Ubuntu 16.04, have a look at our dedicated Ubuntu 16.04 installation guide.

Install Docker Engine

Buddy requires Docker Engine to run. Follow Docker installation instructions at

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`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 Enterprise

To install Buddy Enterprise, run the following in the terminal:

curl -sSL | 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 Enterprise 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.

  • If you are connecting through proxy server, add HTTP_PROXY environmental variable pointing to the proxy address. You can do this by calling in bash:

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

Set up your first workspace

When the installation is over, Buddy Enterprise 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 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


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

Download Buddy Enterprise

Sign up for free

No setup fees. No requirements. No obligation.

or sign up with